Skip to content

Latest commit

 

History

History
46 lines (37 loc) · 2.15 KB

CONTRIBUTING.md

File metadata and controls

46 lines (37 loc) · 2.15 KB

Contributing

emacs-lsp is a very active organization so before you start working on a feature/issue make sure that there is a corresponding issue and drop a note that you start working on that to avoid collisions. Feel free to ping the maintainers in Discord chat or in the issue report if you need help/clarification on how things work.

If you discover issues, have ideas for improvements or new features, please report them to the issue tracker of the repository or submit a pull request. Please, try to follow these guidelines when you do so.

Issue reporting

  • Check that the issue has not already been reported.
  • Check that the issue has not already been fixed in the latest code (a.k.a. master).
  • Be clear, concise and precise in your description of the problem.
  • Open an issue with a descriptive title and a summary in grammatically correct, complete sentences.
  • Mention your Emacs version and operating system.
  • Mention the lsp-mode and related packages version info.
  • Include any relevant code to the issue summary.

Reporting bugs

When reporting bugs it's a good idea to go through the [Troubleshooting section of the documentation][7]. Adding information like the backtrace and the lsp-log buffer to the bug report makes it easier to track down bugs. Some steps to reproduce a bug reliably would also make a huge difference.

Pull requests

  • Read how to properly contribute to open source projects on Github.
  • Use the same coding conventions as the rest of the project.
  • Make sure that the unit tests are passing locally via make test or via the CI.
  • Write good commit messages.
  • Update the [changelog][6].
  • Code-style/formatting changes and typo-fixes should go into their own commits and put into the .git-blame-ignore-revs file to avoid thrashing the git blame data.