Firstly, thanks for thinking about contributing to ltx
!
Here's some guidelines that will help you get your pull requests merged more quickly/easily.
Note: If there's a feature you'd like, there's a bug you'd like to fix, or you'd just like to get involved please raise an issue and start a conversation. We'll help as much as we can so you can get contributing - although we may not always get back right away :)
Most of the coding standards are covered by .jshintrc
. You can also test
any changes with grunt test
(this will also run the tests).
Things not covered by jshint:
- Unless required no semicolons they are not required
- Short one-line
if
statements do not require nipple brackets (provided functionality is clear) - Multiple conditionals within an
if
statement should be surrounded by brackets exports
/module.exports
should be at the end of the file- Longer, descriptive variable names are preferred, e.g.
error
vserr
We acknowledge all the code does not meet these standards but we are working to change this over time.
All code (unless very trivial, or documentation) should be accompanied by tests. If you are unsure about testing please make a pull request and we'll try and help you get some tests in place for your code.
Tests are run using npm test
and should all pass before you make a pull request.
If you pull request relates to an issue, please name your test after the issue number (e.g. 'issue #58') so we can track it if there is a regression.