https://github.com/bonsai-rx/docs
Documentation, technical reference manual, and examples for the Bonsai visual programming language
https://github.com/bonsai-rx/docs
bonsai-rx docfx docs
Last synced: 10 months ago
JSON representation
Documentation, technical reference manual, and examples for the Bonsai visual programming language
- Host: GitHub
- URL: https://github.com/bonsai-rx/docs
- Owner: bonsai-rx
- License: cc-by-sa-4.0
- Created: 2022-01-18T14:58:01.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-07-10T15:40:29.000Z (11 months ago)
- Last Synced: 2025-07-10T20:35:24.556Z (11 months ago)
- Topics: bonsai-rx, docfx, docs
- Language: HTML
- Homepage: https://bonsai-rx.org/docs/
- Size: 5.24 MB
- Stars: 2
- Watchers: 4
- Forks: 10
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bonsai Documentation
[](https://github.com/bonsai-rx/docs/actions/workflows/build.yml)
This repo contains the technical reference manual for the Bonsai visual programming language, in addition to articles and examples that document the collective knowledge of the Bonsai user community.
> [!NOTE]
> This repo hosts the documentation for packages in the Bonsai standard library. Documentation for other Bonsai packages is hosted from each package repo.
Documentation is built using `docfx`, a static site generator that automatically generates API documentation for .NET projects, and deployed using GitHub Actions on GitHub Pages.
# Contributing
Bonsai is a programming language with a growing community of users and developers. Anyone is welcome to participate by reporting bugs, proposing features or improvements, or contributing pull requests directly to our open-source repositories.
For more information please see our [Contributor Guide](https://bonsai-rx.org/contribute/). By contributing to our project, we also expect you to uphold our community [Code of Conduct](https://bonsai-rx.org/code-of-conduct).
# Quick start guide for contributing to documentation
These instructions apply to repos that already have a `docfx` website created.
1. Fork the repository you want to contribute documentation to.
2. Ensure that you are working off the `main` branch in your fork and create a descriptively named branch for each article/issue that you want to work on.
3. Download and install dotnet (https://dotnet.microsoft.com/en-us/download)
4. From a terminal window, restore `docfx` by running:
```powershell
dotnet tool restore
```
5. Navigate to the directory where the file `docfx.json`is located and run the following command to generate a local preview of the documentation website as you are making changes.
```powershell
dotnet docfx --serve
```
6. When you are ready to have your contribution reviewed, commit your edits to the appropriate branch of your fork and create a pull request to merge that branch with the `main` branch of the original repo.
7. Community maintainers will be assigned to review the PR and will conduct the final review and quality control check. If the contribution passes this final step, the PR to merge with `main` will be approved and the contribution will be published.
Check out the [Documentation Style Guide](https://bonsai-rx.org/docs/articles/documentation-style-guide.html) for content formatting tips and the [Documentation With Docfx](https://bonsai-rx.org/docs/articles/documentation-docfx.html) article if you need help with `docfx`.