Building Documentation¶
CLA¶
To contribute to the Binary Ninja documentation, first sign the contribution license agreement and send it to Vector 35.
Prerequisites¶
- sphinx
- breathe
- mkdocs
- doxygen
- The following mkdocs plugins:
mkdocs-callouts mkdocs-click mkdocs-include-markdown-plugin mkdocs-material mkdocs-glightbox mkdocs-htmlproofer-plugin mkdocs-redirects
Building¶
git clone https://github.com/Vector35/binaryninja-api/
cd binaryninja-api
mkdocs build
echo User documentation available in site/
cd api-docs
make html
echo API documentation available in build/html
Changing¶
Changing documentation for the API itself is fairly straight forward. Use doxygen style comment blocks in C++ and C, and restructured text blocks for python for the source. The user documentation is located in the api/docs/
folder and the API documentation is generated from the config in the api/api-docs
folder.
Tip
When updating user documentation, the mkdocs serve
feature is particularly helpful.