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, please remember that GitHub usernames also start with the at sign. If you don't wrap them in backticks, users will get unintended notifications from you.
GitHub has other great markdown features as well, go here to learn more about them.
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.
- 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 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 testto see if they pass node.js tests and
make browser-testto see the browser (PhantomJS) tests pass.
- Always use spaces, never tabs
- End lines in semi-colons.
- Loosely aim towards jsHint standards
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.