Welcome to Mozilla Science Lab's Study Group Orientation!


3.3 Assignment: Get your Study Group Website and Repo Up and Running!

Everything you need to set up your own Mozilla Study Group website for organizing events is right here - follow the following steps and you'll be up and running soon.

  1. Make yourself an account on GitHub. The free one is just fine.
  2. Fork this repository. Up in the top right corner of this page, there's a button that says 'Fork'; press it! This makes your very own copy of all this stuff in your space on GitHub; when the copy is done, GitHub will automatically take you there.
  3. Turn on the Issue Tracker. An issue tracker is a message board GitHub sets up for every repository; you'll use it to post information about your event and talk to your participants. To turn it on:
    • click on 'Settings' in the right sidebar of your repo;
    • click the checkbox beside 'Issues'
    • head back to your repo by clicking on the big studyGroup at the top of the page.
  4. Edit your README file. Remember the text about your group that you wrote back in Section 1? In your directory of files, click on README.md and edit the generic text to include all the specific info about your group and what it's all about. If you'd like to do a bit of fancy formatting (headings, bold, italics, etc) you can use the built-in [GitHub Markdown toolbar] (https://help.github.com/articles/about-writing-and-formatting-on-github/).
  5. Edit the _config.yml file in your new repository:
    • click on _config.yml;
    • click on the little pencil near the top right;
    • follow the instructions in the file on how to edit it;
    • when you're done, press the green 'Commit Changes' button at the bottom of the page.
  6. That's it, you're done! You can see your new website at https://yourUserName.github.io/studyGroup/, where yourUserName is the user name you signed up for GitHub with. If this is your first time making a webpage on GitHub, it might take 30 minutes for things to percolate through GitHub's computers - don't worry, it's all good! Check back later and your website should be up and running.

If you have any trouble with the above steps, let us know on the Gitter chat mozillascience/studyGroup or in an issue, and we'll help you out!