The repository holds the code and markdown source files for the Avalonia UI documentation website, which is accessible at docs.avaloniaui.net
We welcome your valuable feedback on the documentation! Please feel free to join our Community on Telegram and send us a message. We would be delighted to hear from you and assist you with any queries or concerns you may have.
If you come across any issues with the documentation or have a feature request related explicitly to it, we encourage you to create a new GitHub issue. Before creating a new issue, we kindly request that you check for existing issues to avoid duplication.
To contribute to Avalonia UI documentation, you need to fork this repository and submit a pull request for the Markdown and/or image changes that you're proposing.
The two suggested workflows are:
- For small changes, use the "Edit this page" button on each page to edit the Markdown file directly on GitHub.
- If you plan to make significant changes or preview the changes locally, clone the repo to your system to and follow the installation and local development steps in Local setup.
-
The front matter for every markdown file should include the
id
and atitle
.id
will be used to reference the file insidebar.js
orversion-x.x.x-sidebars.json
for a specific version.--- id: platform-support title: Supported Platforms ---
-
Use lowercase for file and folder names and dashes
-
as separators. For example:/docs/getting-started/ide-extensions.md
/docs/how-to/use-google-fonts.md
-
Images are important to bring the product to life and clarify the written content. For images you're adding to the repo, store them in the
img
subfolder insidestatic
folder. For every topic there needs to be a folder inside\static\img\
section, for example:static\img\how-to\use-google-fonts\download-font.png
. When you link to an image, the path and filename are case-sensitive. The convention is for image filenames to be all lowercase and use dashes-
for separators.Example code for adding an image in markdown file:
<div style={{textAlign: 'center'}}> <img className="screenshot-full" src="/img/button-group.png" alt="Button group" /> </div>
- Node version >= 18
npm install
npx docusaurus start
Thanks for all your contributions and efforts towards improving the Avalonia UI documentation. We thank you being part of our β¨ community β¨!