Thank you for your interest in contributing to YARP! Below are a couple of ways that you can help out.
The discussions page on the GitHub repository are open. If you have a question or want to discuss the project, feel free to open a new discussion or comment on an existing one. This is the best place to ask questions about the project.
If you want to contribute code, please first open or contribute to a discussion. A lot of the project is in flux, and we want to make sure that you are contributing to the right place. Once you have a discussion going, you can open a pull request with your changes. We will review your code and get it merged in.
We could always use more tests! One of the biggest challenges of this project is building up a big test suite. If you want to contribute tests, feel free to open a pull request. These will get merged in as soon as possible.
We can run the native (C) tests with make test.
We can run the Ruby tests with rake (you will need to run bundle before)
We could always use more documentation! If you want to contribute documentation, feel free to open a pull request. These will get merged in as soon as possible. Documenting functions or methods is always useful, but we also need more guides and tutorials. If you have an idea for a guide or tutorial, feel free to open an issue and we can discuss it.
To get clangd support in the editor for development, generate the compilation database. This command will
create an ignored compile_commands.json file at the project root, which is used by clangd to provide functionality.
You will need bear which can be installed on macOS with brew install bear.
bundle exec rake generate_compilation_databaseFor VS Code, install the clangd extension to get the features provided by the language server.