This folder contains Mozilla Clubs guides & resources.

Adding a new guide via drag & drop!

Note - Drag & drop does not work in Firefox! Please use Chrome.

  1. Download the Template Folder zip file
  2. Unzip it
  3. Edit the content.md file only
  4. Rename the folder to match the content title, this will be a part of the URL so…
    • Make it all lowercase
    • Don’t use special characters
    • Replace spaces with dashes (like-this)
  5. Drag and drop the finished folder into the clubs folder on the gh-pages branch - Right Here.

Viewing a Published Guide

Your new page will be available at


Editing existing pages

If you already have the folder & files on your computer
  1. Edit the content.md file on your computer and save it.
  2. Drag the folder into the clubs folder (just like outlined above).
  3. Warning - your content will totally override what is in the repo
  4. Basic syntax guide https://guides.github.com/features/mastering-markdown/

Here is a handy Markdown Guide to help you with formatting your content.

If it is not
  1. Navigate to the content.md file you want to edit in the Github UI
  2. Click the Pencil icon near the top right of the file contents
  3. Use the Preview tab to check your changes.
  4. When you’re ready, click the Comitt button to save your changes

Changing the name of the folder

Unfortunately, you can’t do this within the Github UI, so you’ll have to upload another folder with the correct name.

Adding images

To display an image in a guide, use the following markdown syntax…

![image alt text](https://example.com/image.jpg "Image Title Text")

You can also add an image file to the folder that contains your guide, and then use the following markdown syntax to display it…

![image alt text](image.jpg "Image Title Text")

Deleting Guides

  1. Navigate to the specific file you want to delete
  2. Click the Trash icon in the top right of the file content
  3. If you delete both files in the folder, the folder will be deleted automatically

The links on the Guides & Resources page on the Learning site are generated from the clubs-resources.json file found in this folder. When you make changes to this file, they will take effect immediately on the Learning site.

####Tips for editing this file