Contributing

Documentation

MarkMapper needs your help to make the documentation better. Here’s how to contribute:

1. Fork the repo on GitHub and check out the gh-pages branch.
   

   $ git checkout -b gh-pages origin/gh-pages

2. Install the github-pages gem
   

   $ gem install github-pages

3. Run the Jekyll server
   

   jekyll serve --watch

4. Open up http://localhost:4000/ in your web browser
5. Make your documentation changes
6. Push your changes and submit a pull request

Suggestions

If you want to help with the documentation, but don’t know how to help, here are some ideas of things that need documented.

Guidelines

In order to maintain quality, here are some guidelines for contributing to the MarkMapper documentation.

• Don’t document hacks or workarounds. If MarkMapper is broken or doesn’t support something, note it in the docs and add an issue to the issue tracker.
• Avoid narratives. People don’t really care why you’re writing the documentation, they just want to know how to use MarkMapper.
• Be concise without sacrificing clarity.