📣 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.lua
📝 NOTE: Tests are currently not working on Windows. Test run will only verify if tree-sitter grammar can be installed, and exit with a success message.
Parsing is done via builtin treesitter parser and the tree-sitter-org grammar. Ensure that you follow the Conventional Commits specification (e.g.,feat: add new feature, fix: correct bug, docs: update documentation).