Skip to content

Latest commit

 

History

History
49 lines (32 loc) · 2.32 KB

CONTRIBUTING.md

File metadata and controls

49 lines (32 loc) · 2.32 KB

Contributing to nvim-dev-container

First of all, thanks for taking the time to contribute to the project!

Following is a basic set of guidelines for contributing to this repository and instructions to make it as easy as possible.

Parts of this guidelines are taken from https://github.com/atom/atom/blob/master/CONTRIBUTING.md

If you do not have an account registered and do not want to register one, you can use mailing lists to report bugs, discuss the project and send patches:

Table of contents

Reporting bugs

Follow the issue template when reporting a new bug. Also try to provide log which can be found with DevcontainerLogs command or with require("devcontainer.commands").open_logs() function. Export env variable NVIM_DEVCONTAINER_DEBUG=1 to produce more logs (e.g. start neovim with NVIM_DEVCONTAINER_DEBUG=1 nvim).

Styleguides

Commit messages

  • Use the present tense ("Add feature" not "Added feature")
  • Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
  • Limit the first line to 72 characters or less
  • Reference issues and pull requests liberally after the first line
  • Project uses Karma commit message format

Lint

This project uses luacheck and stylua. Script is provided to prepare pre-commit hook to check these tools and run tests (scripts/devsetup).

Generating documentation

Documentation is generated using lemmy-help. To generate documentation run scripts/gendoc.

Running tests

Running tests requires plenary.nvim and nvim-treesitter to be checked out in the parent directory of this repository.

Tests can then be run with:

nvim --headless --noplugin -u tests/init.vim -c "PlenaryBustedDirectory tests/ {minimal_init = 'tests/init.vim'}"