The How to Guide

Hosting your first Rails Girls event

Our aim is to give tools for women to understand technology. The Rails Girls events do this by providing a great first experience on building the Internet.

Rails Girls was founded in end of 2010 in Helsinki. Originally intended as a onetime event, we never thought we’d see so many local chapters all around the world! This guide has been put together to help you get started.

If you want to organize an event, start by filling out http://railsgirls.com/inyourcity and you’ll receive more instructions.

The roadmap for future events can be seen at www.railsgirls.com.

The Basics

Rails Girls events are non-profit. We don’t charge the participants and do not pay for coaches or speakers. Participants don’t need any previous knowledge about programming and there are no age-limitations. All the participants need is a laptop and some curiosity.

The two-day event includes a lot of small group working and short focused talks on programming, design and web. No panel discussions or podium-talks - the spirit should be informal and hands-on. The more you can remove abstractions and add inclusivity the better.

Rails Girls philosophy

Example Program

Every Rails Girls event starts with an installation-fest where the setup is pre-installed to the girl’s computers. See guides.railsgirls.com/install for readymade instructions. The installation-fest can include short talks, but the main point is to offer some sparkling wine, get everything set for the next day and the women to know each other. The timeframe is tentative - you know your audience and what suits them best. We’ve hosted events both during weekend and weekdays. Also, doing two evenings (4PM - 22 PM) might be a more suitable solution for your community needs.

Learning objectives of the workshop:

Friday evening: Installation

19:00 - 21:00 Installations and getting to know each other Hint: Have a coach table where problematic computers can be brought.

Some installations will fail: be prepared to set women up in pairs, don’t use endless amounts of time.

Decorate the place with balloons and posters. Put a fun playlist together for the evening.

Come up with activities to break the ice: ask the girls to write why they are attending the event on post-its or to draw and describe their dream web app.

Remember to do a FridayHug!

21 -> Coach dinner Go through the application with the coaches during dinner.

Saturday: Workshop

09:00 - 10:00 Registration and coffee Hint Reserve enough time for people to mingle and to solve any problems there might be with installations. Give out workbooks, collect acronyms for the Bento exercise.

10:00 - 10:10 Welcoming words Hint Mention sponsors, show what we’ll build, tell what programming is.

10:30 - 11:00 UX workshop

11:00 - 11:30 Introduction to programming Hint Ask one of the coaches to do this. Explain why learning Ruby basics is important even though they’ll be using Rails.

Themes to cover: + The difference between dynamic and static websites: what are web apps? + What are programming languages? What is Rails? + The tools we’ll be using: browser, terminal, code editor, folder structure

Show & tell with tryruby.org, first three-four exercises all together.

11:30 - 13:00 Workshop time Going (slowly!) through the curriculum at guides.railsgirls.com/app. Stop to explain what you’re doing and what the different concepts mean.

Try to aim for simple explanations even with the cost of accuracy. You don’t need to talk about all underlying concepts. Just try to answer questions when they arise, or move on if they’re too hard or out of scope. You are not here to teach perfect coding skills but to show how to get stuff done. One has to learn how to build web apps before learning how to do it well.

Concepts to cover: + Rails Generators + Scaffolds: Rails App Structure + Gem Management + MVC, REST/Resources + Models and Active Record + Controllers and ActionController + Views and ERB

Tips: Coaches are people too. They are doing this for the first time too. Teaching might be hard and intimidating, so remember to be available to help coaches or groups with difficult situations or just provide support and encouragement.

13:00 - 14:00 Lunch

14:00 - 14:30 Bentobox exercise Putting technical jargon into a context with a conceptual model called Bentobox.

Two exercises: 1) Going through the 10 technical concepts with the physical Bentobox boards. 2) Going through the words the women have themselves submitted with the coaches.

14:30 - 18:00 Workshop time.

Time to continue working on the applications. Monitor the situation: when it seems like people have a hard time concentrating, have the coaches or other speakers give quick lightning talks.

Example topics for lighting talks: + Real (female) programmers telling what their career has been like. + Design: UX & UI. Making mockups together either with paper or computer. + Fun ways of explaining technical concepts and recent frameworks: what is CoffeeScript explained in 80s pop songs? How would you describe GitHub? What coding and creative writing have in common? + Show us something real: don’t speak in abstractions, be specific and tell stories.

Once everyone has finished their app, there is time to extend the application by modifying the CSS, implementing commenting systems etc. Allow enough time for experimentation.

19:00 After party Hint: Invite everyone, also the local developers, boys, those who weren’t accepted, to join!

Fork this project on GitHub, add yourself, and send us a pull request.

Materials

Promotion of Rails Girls

Every Rails Girls workshop will get a custom website at railsgirls.com/city where the information is collected and then stored. For past cities, see railsgirls.com/events

You can also set up your own Facebook and Twitter page (remember to add links to your workshop’s page!) or whatever service is popular in your community. Promoting the event through social media can go a long way these days, but make sure you have somebody to take care of the chosen channels. Some tips:

While the event is underway, remember to take pictures, collect tweets and ask questions of the participants. You’ll be thankful for all of that for your next event. We love to write blog posts about the speaker and participant experiences. A list of the coaches is also required.

Website

E-mail contact(a)railsgirls.com and ask to be included in the repo. Look for readme.txt for further instructions! Before making a site you should have at least two coaches and one sponsor onboard.

How to find local developers?

How to find participants?

How to get press?

One of the big aims of Rails Girls is to make it more mainstream for women to build the web. That’s why we like to engage the local press and highlight the participants and their enthusiasm. We’d be happy to help prepare a press-release for the media. Check out railsgirls.com/press for more. If you’re working with a big company as a sponsor, their PR department might be able to help you spread the message about the workshop.

Send the press release to local blogs, find contact at various media outlets. The more doors you knock on, the greater you chance of getting through. Make a list of journalists and bloggers you contact, mark those that respond to your emails, so they can be the first ones to receive your next press release. You can also write a press release after the event that includes photos and statements from satisfied participants.

Sponsorships

Rails Girls talks to a demographic that might be hard to reach other ways: women who have an interest in technology, who are possible users, employees or partners of the sponsoring company.

We are looking for sponsors who are active participants in the local technology scene, whether it’s a startup or a big corporation, a non-profit or a government organization.

Also non-traditional technology companies can be approached: kids stores, universities, women’s magazines, beverage brands etc. They all should however have some affiliation or interest in technology.

Rails Girls should always be kept non-profit: if there’s money left, it should be used to support the future activities of the attendees. Don’t forget that you don’t need that much funding and even a two-person startup could be very willing to chip in.

Example letter for sponsors

Dear xxx,

We are organizing a Rails Girls programming workshop in (insert city) on (insert dates).

Rails Girls is a two-day non-profit event for women of all ages to give them a great first experience in software craftsmanship. We aim to give the tools to understand technology along with the community and inspiration to get started.

Rails Girls is not just about programming, it’s about building things. During the workshop, we’ll build an application and also have inspiring lightning talks and exercises.

For a closer look, please see www.railsgirls.com for past events and coverage.Here’s also a short video on the Berlin event held in April 2012: http://vimeo.com/40852182

We are now looking for sponsors to help us realize this all. We’d love to have your support!

Yours, name

How much does it cost?

The costs below are estimated for 30 participants, 10 coaches - but they may vary a lot. It’s easiest to try to get a local sponsor to pay the bills directly or partner with someone who has a set account to handle money. These calculations are done in Finland, in €, where food & alcohol is very expensive, but spaces are often free. All in all you should be able to organise an event easily for a little over a thousand euros.

What do sponsors get?

Don’t give out the participant info, but sponsors are free to hang out at the event and be sure to include a short message to the sponsor in a thank-you note. Sponsor swag may be included in the goodie bag to an extent, but it should be something tasteful, not trashy and/or related to women.


FAQ

Who can organise a Rails Girls workshop?

Anyone. What we look for is a group of people dedicated in making this a stellar first experience in the world of web making for women. What we hope to see is some (not all) of the following:

Start by filling out http://railsgirls.com/inyourcity and someone from our team will be in contact

Where can I find all the materials for posters, nametags, sample presentations and such?

Check out below, and let us know if something is missing! + Download materials

What kind of venue is needed?

We recommend choosing a venue with a built-in infrastructure for around 30-50 persons. For a programming event, this means: * High-speed, tested Internet. There’s going to be over 30 computers online all the time. Add to that mobilephones, streaming music, funny videos and you get the picture! * Space for 4-6 person groups to gather together: chairs and tables, sometimes big pillows will do! This doesn’t have to be in the same room. * Possibility to set up extension chords and a projector. * Enough electric outlets to spare. Some women might have older laptops that will need to be plugged in at all times. * Location for food and beverage setup - lunch space for catering or a nearby lunch venue. * External monitors for teams are encouraged but not mandatory, helps the coaches show what is happening in the code. * Whiteboards can be helpful for coaches to explain more abstract concept. Alternatively, paper and pen work just fine. Just have something at hand people can draw on.

Ask where local developer meetings are usually hosted. Often co-working spaces are also willing to negotiate deals to gain some visibility among new people.

What is expected from the coaches?

Rails Girls events are organized around small groups, maximum of 4-5 persons per one coach. If possible, try to have groups of 3 women for each coach. For instance, if you’re doing an event for 30 women, aim for having 10 coaches (a few more for backup don’t hurt). We know this isn’t always possible, but do try not to have groups of more than 5 women, so the coach can still answer all questions in the group.

The coaches don’t need to be hardcore experts on Rails - basic knowledge and willingness to explain trumps expertise. So, if your local Rails community isn’t very strong, do expand your search. You can have a mix of Rails experts and people with web development expertise in other frameworks. We are looking for people who like answering questions and can keep an upbeat and positive atmosphere through a period of 8 hours!

You can get to know the curriculum by checking out guides.railsgirls.com/app. There is also always a pre-event coach dinner where we’ll go through some pedagogical suggestions and check everyone knows what is happening. Avoid jargon, tie examples to what your doing, encourage asking questions. The installation instructions can be found at guides.railsgirls.com/install. We also understand that coaches are human and that for most of the people this is the first time teaching something. Worry not - the women have always been really happy with whatever they learn and just the chance to ask questions is enough.

We hope the coaches are ok with having their name and twitter-id/github/some mean of contact on railsgirls.com so the women always have a local face to answer their questions.

In addition, we encourage coaches to come up with additional exercises for the group. After completing the ideation app many women will want to try tweaking the look & feel of the site, implementing commenting, Facebook sharing, pushing the app to Heroku, etc.

How to find coaches?

Ask around, ask sponsors (tech companies), ask anyone to help you out. Once you do get some coaches on board, they can help you out with their own contacts. Influential bloggers or Twitter users in your local dev community can help you out by broadcasting a call for coaches. Hint: You can also thank coaches for their help by providing a spot at the workshop for their girlfriends ;)

Sample letter for potential coaches

“Dear community member,

We wish to invite you to take part in the Rails Girls event on (insert date). The event is aimed for women of all ages with no previous programming experience, but a lot of passion to building things. Rails Girls is an international non-profit, volunteer-based workshop. We’ve had events in Shanghai, Berlin, Helsinki, and Singapore. We expect to receive around a 100 applications.

In addition to giving a safe and fun first experience to coding for the women we want to engage them with local developers, open source, and the startup scene. We’ve attached some information on what coaching requires in practice. In addition, we have room for small lightning talks on technical subjects. If you have something you’d like to speak about, let us know.

For more information about the non-profit event, check railsgirls.com or guides.railsgirls.com

(You can also include the chapter “What is expected from the coaches” to the mail)”


What materials do I get?

Each Rails Girls event gets a specific webpage.

In addition we’ll help you out with the goodie bags, poster templates, workbooks and other swag like stickers, reflectors and so forward. All of the materials can be found on this site. You can also ask the sponsors to include some sponsor materials if they wish. We are always looking for creative outlets for the Rails Girls brand, if you have ideas, let us know!

So far we’ve had

Also, check out:

How do I choose attendees?

In the form we ask only two questions: do you have any previous background in coding and why would you be a good participant for Rails Girls

Rails Girls is intended for anyone and we want to keep it flexible enough for learners any age. However, make clear to the attendees what to expect: Rails Girls won’t make anyone into a coder, so people looking for i.e career change will be disappointed. On the other hand we like people with very diverse backgrounds and loads of enthusiasm.

After selecting participants we generally split them into three groups:

  1. people with no previous programming experience
  2. people with some front-end experience (HTML, CSS, Javascript) and
  3. people with a little experience in programming or a background in computer sciences. You can use the different name-tags for each group if you want to (rubies, foxes, octocats, rails..)
Sample letter of acceptance

Title: Rails Girls workshop - welcome!

Dear attendee,

Congratulations! We’re happy to invite you to join in on the Rails Girls workshop in (insert city). We hope that this workshop will provide you a great first experience on building web apps.

What happens next?

(Insert date for installation fest) starts at (insert time) with an installation fest - so please bring your laptop with you! You should also try to pre-install Rails with instructions from http://guides.railsgirls.com/install/

We will hold the event in (insert address)

On (insert date) we’ll dive into development. We’ll work in small groups with four to six person teams. Your team members will have about the same experience level as you. We’ll be all developing a simple listing application. We’ll wrap the day around (insert time). There’s also going to be an evening party.

We have a lot of people wanting to get to the class, so if you can’t make it this time, let us know as soon as possible!

If you have any questions, please don’t hesitate to contact me. We’ll also be updating the website at (insert address)!

Best,

(Signature)

Sample letter of not being accepted

Title: Rails Girls - not accepted this time

Dear applicant,

Unfortunately we couldn’t fit you in the workshop this time. To be able to give personal guidance to each participant, we could only take a fraction of the applicants. This time we prioritized women with no previous programming experience.

However, you’re warmly welcome to the official afterparty. (Insert details).

We’ll also be most likely organizing more events in your city. Follow twitter.com/railsgirls or facebook.com/railsgirls for more information.

There’s always cancellations and we fill all available places, so we might still be taking in a couple of people!

Best,

(Signature)

Sample thank you letter for participants

Dear Rails Girls,

Thank you for taking part in the Rails Girls event. We truly felt lucky to have such a talented & enthusiastic crowd of people with us and hope many of you will continue working with Rails in the future - you have the tools, now build something cool!

(Say a few words about the sponsors and coaches - thank you for the community)

Three things we want to share:

Workshop Materials (Almost all) materials can be found in the guides section at http://guides.railsgirls.com. You can find presentations, materials and instructions from the workshop. If you took pictures or blogged about the event - let us know! We’ll be publishing regularly on blog.railsgirls.com

Make Rails Girls better - give us feedback! We want to hear from you! Give us feedback about the workshop or how we can make the event better – it’s really quick, and it’ll help us improve our workshop at railsgirls.com/feedback

Keep on coding! We realize there was quite a lot of stuff in todays lecture and for most of you it all felt a little overwhelming. We strongly recommend trying out Rails for Zombies exercise at http://www.codeschool.com/ latest by next weekend, it’ll refreshen all you’ve learned so far and teach you some more.

Two things to keep you going: - (Insert here a couple of community events that the participants should take part in)

There was a LOT of interest in doing follow-up events. If you have ideas for this or want to volunteer for the organizing team, let us know and sign up for the group e-mailing list at http://groups.google.com/group/rails-girls-team!

And thats all for now, Your Rails Girls team

What happens after the event?

Inviting real developers to coach is Rails Girls sessions not only gives the participants a chance for hands-on education, but also makes the barrier to enter the technology world lower. How to keep the women coding?


Checklist

This is a small checklist for your event. Rails Girls can be thrown together in a matter of weeks, but to truly have time to make a good event, prepare at least two months. Not all of these steps are of course mandatory and they are here just to help you remember.

Before the event:

During the event

After the event