railsgirls/guides.railsgirls.com

This repository contains the written guides for Rails Girls, a volunteer-run movement that organizes free workshops to help women get started with building web applications. The movement started in Helsinki in 2010 as a one-time event and has since spread to cities around the world. The guides here are the instructional materials used at those workshops and are also available online at guides.railsgirls.com. The guides walk participants through building a simple web application using Ruby on Rails, a widely used framework for creating websites and apps. Rails is a programming framework built on the Ruby language, though the guides are written to be accessible to people with little or no prior coding experience. Workshop organizers, called coaches, accompany participants through the steps and explain what is happening at each stage. The repository itself is a website built with Jekyll, a tool that converts text files into a static HTML website. If you want to run the site locally, you install Jekyll, run a single command to start a local server, and the guides appear in your browser. Contributing a new guide or fixing an existing one involves editing those text files and submitting a pull request. The guides are licensed under Creative Commons Attribution-ShareAlike 3.0, meaning anyone can reuse and adapt them freely as long as they credit the source and share adaptations under the same terms. The content is openly maintained by the global Rails Girls community, and contributors are encouraged to add their names. Anyone who wants to run their own Rails Girls event can use these materials to organize a workshop in their city, workplace, or home.