Skip to content

Latest commit

 

History

History
42 lines (33 loc) · 1.88 KB

CONTRIBUTING.md

File metadata and controls

42 lines (33 loc) · 1.88 KB

Contribution Guidelines

First and foremost, thanks for contributing! I'm only one person and for this package to truly provide a first-class LaTeX experience from within Atom, your contributions are crucial.

Before you set out on your adventure, please read this document carefully. It will save everyone involved both time and energy.

Styleguides

The short story is to use common sense and follow the existing styles and conventions, whether it's Git commit messages, JavaScript code, documentation, and so on.

Git Commit Messages

  • The first line should be a short summary limited to 50 characters.

  • All other lines should be limited to 72 characters.

  • The first line and the (optional) detailed summary must always be separated by a single blank line since many tools rely on this convention.

  • Additional paragraphs should also be separated with blank lines,

  • Use the present tense; “Add feature” and not “Added feature”.

  • Use the imperative mood; “Fix bug …” and not “Fixes bug …”.

  • Reference issues and pull requests. If a commit resolves an issue, mention that in the summary, and prefix the reference with either “close”, “fix”, or “resolve” to automatically close the referenced issues when your pull requests are merged.

    See https://help.github.com/articles/closing-issues-via-commit-messages/.

For additional details and inspiration, see Tim Pope's excellent post on commit message best practises.

JavaScript Styleguide

standard

This project follows the JavaScript Standard Style. Compliance with the rules is automatically checked during CI builds. If you want to check if your changes are adhering to the rules, simply execute script/lint.