Contribute Content

So you want to make a PR

GREAT! We love pull requests. The easiest way to get involved is to write about your experiences with Python and PyLadies on our blog. Here are a few steps to help you get started:

  1. Decide what you will write. It may be helpful to draft it out in your word processor or text editor of choice first.

  2. Fork this repo!

  3. Clone your fork to a directory on your machine so that you can develop in your text editor of choice.

  4. Add a .md file with your post in the 'content' folder on branch master. Blog posts and articles both show up on the main stream, files in the pages directory are for the sidebar pages only. Your file needs to have a line with the title Title: {{ your awesome title here }} and may have any/all of the following metadata:

Date: 2010-12-03 10:20

Modified: 2020-12-05 19:30

Category: Blog # PLEASE CHOOSE AN EXISTING CATEGORY - We may edit your category if it does not match our menu bar.

Tags: pelican, publishing # Choose any tags you like! Tag it up!

Slug: my-super-post # Defaults to your title, but you may set it directly.

Authors: Cleveland PyLadies, Floaty McFloatFace # Own it, lady!

Summary: Short version for index and feeds # Again all of these are optional.

Your super content goes below your metadata block. Remember to commit changes with meaningful messages before moving on!

Current category options:

  • Blog

  • PyLady Profiles

  • Anything other than these needs to be discussed before approval

You can preview changes you've saved locally with the following steps:

  • open a terminal and run cd pyladies-official (the location of your cloned fork)

  • run python -m venv myvenv if you haven't already done so in that directory

  • run source myvenv/bin/activate to activate the virtual environment you created for this project

  • run pip install --upgrade pip and then pip install -r requirements.txt if this is the first time you've activated this virtual environment

  • run pelican content to generate the site html files locally

  • run ./develop_server.sh start to make your version of the site available locally

  • preview your version of the site by opening http://localhost:8000 in your internet browser of choice.

When you are satisfied with the look of your article or other change:

  1. Check to see if your fork is behind the main repo by any number of commits. These may cause problems if merge commits emerge between fork and PR. Contact us on Slack or Twitter if you are unsure.

  2. Make a new pull request from the main repo. There is a green "New pull request" button to start this process. On the next page, select compare across forks, set your fork master as the head, give your PR a meaningful title/description, and submit your request (green "Create pull request" button).

  3. BOOM! You're officially an open-source contributor. We may ask for changes before merging your fork, but you've successfully gotten started! Shoot us an email or get at us on social if more than a week goes by and we haven't addressed your PR. We are very encouraging of new contributors, so give it a shot!