Skip to content

Latest commit

 

History

History
39 lines (28 loc) · 1.71 KB

CONTRIBUTING.md

File metadata and controls

39 lines (28 loc) · 1.71 KB

Contributing

Contributions are welcome! Here's how you can help:

Code

For small fixes or incremental improvements simply fork the repo and follow the process below. For larger changes submit an RFC:

  1. Fork the repository and clone your fork.

  2. Start coding!

    • Configure clangd LSP by generating compile_commands.json (e.g. bear -- make or compiledb make)
    • Implement your feature.
    • Check your code works as expected.
    • Run the code formatter: clang-format -i $(git ls-files "*.cpp" "*.h")
  3. Commit your changes to a new branch (not master, one change per branch) and push it:

    • Commit messages should:
      • Header line: explain the commit in one line (use the imperative)
      • Be descriptive.
      • Have a first line with less than 80 characters and have a second line that is empty if you want to add a description.
  4. Once you are happy with your changes, submit a pull request.

    • Open the pull request.
    • Add a short description explaining briefly what you've done (or if it's a work-in-progress - what you need to do)

Issues

  1. Do a quick search on GitHub to check if the issue has already been reported.
  2. Open an issue and describe the issue you are having - you could include:
    • Screenshots.
    • Ways to reproduce the issue.
    • Your lidm version.
    • Your platform (e.g. arch linux or Ubuntu 15.04 x64)

After reporting you should aim to answer questions or clarifications as this helps pinpoint the cause of the issue.