Submitting a draft for SitePoint's Peer Review
This section will thoroughly teach you how to submit your article for Peer Review. It contains important information about what to consider before submitting.
We only accept drafts in a MarkDown (.md) file. If you are not familiar with MarkDown files, here is a great resource to get you started.
Video: How to create a draft for Peer Review
Please watch this video on creating a draft for peer review.
Submitting your draft
Note: If if you have not familiarized yourself with GitHub, please read this tutorial before proceeding.
Step by Step submission:
Fork the peer review repo you’ve joined. If you have a fork already, synchronize it with the original version (in case the original was updated with other people’s posts since you forked it, for example) as per this post.
Create a new branch for every article you intend to write – this is very important. Make sure every new branch is based off of the master branch of your fork. A common error is branching when already on another branch, which will cause your pull requests to be turned into a single pull request if you commit that way. All draft pull requests submitted on the
masterbranch will be rejected.
If there is no folder matching your name yet under the Authors folder, please make one. Make it your full name, but remove local characters. For example, Bruno Škvorc will have the folder “Bruno Skvorc” or “Bruno-Skvorc”.
Make a sub-folder for your post. Prefix the name with the number of posts in your folder. For example, if this is your first post in this repository, prefix with 01. For example, if your tutorial is called “How to set up ACL with Sentry in Laravel”, a good folder name is “01 – Sentry ACL in Laravel” and a bad name is “01 – sentrylar”
Commit the changes you have made, then push them to your fork on GitHub. Notice that we are pushing the branch we created, not the master:
git add . git commit -m "My first article" git push origin my-new-article
Finally, send a pull request.
Multi-part articles: If you got approval from the editor to submit a multi-part post, then put each part in its own folder.
When submission is complete: Once a draft PR is submitted, it will be given a label of peer review:
It will then have to be in peer review mode for a specific amount of time or reviewed by a specific number of people before moving into editor review stage:
The duration and number of needed reviews will vary per channel. Wait for feedback from other authors, or for feedback from the channel editor and make the changes accordingly.