Avalonia API-Reference

This project generates the Avalonia API reference documentation.

How it works

• Avalonia is linked via .gitmodule for the given release branch
• Sandcastle Help File Builder reads the Avalonia API info and generates MDX-files
• Docusaurus uses the created MDX-files to generate a static website

How to build

It is important to mind the build order.

1. build all Avalonia projects
2. build any custom SHFB plug-in
3. build the SHFB project
4. build or preview the docs website

Note

Use the build.ps1 file to run the build. Usage:

# -version: specify the Avalonia version to document.
# -preview: Add this switch if you want to open the preview of the website. If this switch is missing, an optimized build will be created
.\build.ps1 -version 11.2.0 -preview

Known limitations

• The API-Reference is only available for a single version as of now.
• The search functionality is missing, but should be added soon.