📣 Please always make a quick search in our issue-tracker before reporting anything. If the bug/feature has already been reported, continue the conversation on the existing issue.
We distinguish between core
(part of orgmode) and
non-core
features. The former will be prioritized. Bugs get the highest
priority.
If you’re reporting a core
feature, please be sure to provide a link
that describes it. There are several places where features could be
documented, have a look at these resources. The more info you provide the better!
snake_case
instead of kebab-case
.
Example: org-agenda-files
in Emacs is org_agenda_files
in nvim-orgmode.
- StyLua - For formatting
To set up local development, run make setup_dev
. This will add a
pre-commit hook that will auto format all files before committing them.
You can always manually format all files with make format
command
Please document any new code you add with emmylua annotations. Feel free to add annotations/docs to any existing functions integral to your PR that are missing them.
To run tests runmake test
in the nvim-orgmode directory:
make test
To run a specific test you can set a FILE
environment variable to a
specific spec you want to test. Example:
make test FILE=./tests/plenary/api/api_spec.luaParsing is done via builtin treesitter parser and the tree-sitter-org grammar.