Style Guide

This guide is for authors and developers who contribute content to

Things to Know

Here are a few tips to keep in mind before working on this project:

  • Feel free to pull request typos or obvious minor fixes (no issues or discussion necessary).
  • Discuss your article ideas on Slack first.
  • Content is managed with Hugo and located under hugo/content.
  • If you contribute I want to make it worth-your-while (see tier below)

Contribution Tier

I like to give away things you can hold in your hand. Here’s what you can expect:

  • Small fixes or typos === 🔥 Sticker.
  • Guest post or major code improvements === 👕 T-shirt.
  • Course collaboration === 💰 Paid freelance job or revenue share.

How to Fix, Improve, and Create Content via GitHub

First, fork the main repo on GitHub, then clone it to your local machine. You must have Hugo and Node installed.

command line
git clone <your-forked-repo>
npm install
npm run dev

git checkout -b my-fix

After making your fix or adding new content, submit a pull request on GitHub.

command line
git commit -m "fix: corrected a typo"
git push origin my-fix

Writing in Markdown

Content is written in markdown. Posts should only use h2 and h3 tags.


## Step 1: Do Something

some overview text

### Specific Details

[link](/style-guide/) to somewhere useful

Images for lessons are saved in the relative image dir, lessons/<lesson>/img/ and use the Hugo figure shortcode.

{{< figure src="img/my-images.png" alt="cool image" >}}

Add Contributor Bio

Thank you for contributing 🙏. Make sure you add details to the contributors section and save your avatar image to the static/img/contributors dir.

title: Michael Jordan
draft: false

featured_img: /img/contributors/your-avatar.png


I used to play baseball...