Contributing to Less.js
We welcome feature requests and bug reports. Please read these guidelines before submitting one.
Words that begin with the at sign (@
) must be wrapped in backticks! . as a courtesy to avoid sending notifications to any user that might have the @username
being referenced. Remember, usernames start with the at sign.
GitHub has other great markdown features as well, go here to learn more about them.
Reporting Issues
We only accept issues that are bug reports or feature requests. Bugs must be isolated and reproducible problems that we can fix within the Less.js core. Please read the following guidelines before opening any issue.
- Search for existing issues. We get a lot of duplicate issues, and you'd help us out a lot by first checking if someone else has reported the same issue. Moreover, the issue may have already been resolved with a fix available.
- Create an isolated and reproducible test case. Be sure the problem exists in Less.js's code with reduced test cases that should be included in each bug report.
- Test with the latest version. We get a lot of issues that could be resolved by updating your version of Less.js.
- Include a live example. Please use less2css.org for sharing your isolated test cases.
-
Share as much information as possible. Include operating system and version. Describe how you use Less. If you use it in the browser, please include browser and version, and the version of Less.js you're using. Let us know if you're using the command line (
lessc
) or an external tool. And try to include steps to reproduce the bug.
Feature Requests
- Please search for existing feature requests first to see if something similar already exists.
- Include a clear and specific use-case. We love new ideas, but we do not add language features without a reason.
- Consider whether or not your language feature would be better as a function or implemented in a 3rd-party build system such as assemble-less.
Pull Requests
Pull requests are encouraged!
- Start by adding a feature request to get feedback and see how your idea is received.
- If your pull request solves an existing issue, but it's different in some way, please create a new issue and make sure to discuss it with the core contributors. Otherwise you risk your hard work being rejected.
- Do not change the ./dist/ folder, we do this when releasing
-
Please add tests for your work. Use
make test
to see if they pass node.js tests andmake browser-test
to see the browser (PhantomJS) tests pass.
Coding Standards
- Always use spaces, never tabs
- End lines in semi-colons.
- Loosely aim towards jsHint standards
Developing
If you want to take an issue just add a small comment saying you are having a go at something, so we don't get duplication.
Learn more about developing Less.js.