Documentation contributions are welcome. These may be bug fixes or improvements you've identified on your own, or specific changes assigned to you by the product team.
Use the following process to submit documentation.
1. Create a Branch for Your Work
2. Make Your Changes
Apply your changes. Refer to the steps for specific types of changes below.
Change a Document
- Change the document's content as necessary
- Update frontmatter if applicable
- Ensure all your changes conform to the format of document source files
Add an Image
- Create the new image file, ensuring the file conforms to the format of image source files
- Optimize the image file for the web
- Add the new image file
- Reference the image file from a document
Remove a Document
- Remove the document file
- Remove its entry from the navigation tree
- Identify the image files referenced by the document, and remove each file unless it is referenced by other documents (which is rare)
Add a Document
- Add the new document file, ensuring it conforms to the format of document source files
- Add an entry for the new document to the navigation tree
3. Confirm Your Changes
Every markdown implementation is a unique snowflake, so please build the documentation and confirm your changes appear as expected before submitting them for review. Also ensure your changes conform to the documentation style guide.
The following example demonstrates how to start a development server, which will re-build the docs each time you make a change.
$ cd docs && bundle $ bin/middleman
Open the URL displayed in the output to view the built documentation.
4. Submit a Pull Request
After building the docs and confirming your changes, you can submit the changes as a pull request. Follow the same process used for contributing code.