New Content Needed

[grokys]

Mega-list by @maxkatz6:

From https://github.com/AvaloniaUI/Documentation/issues/399

Must be added before 11.0 release:

• [x] ControlTheme documentation, comparison with 0.10 styling. Also would require updating Troubleshooting page. @grokys : https://github.com/AvaloniaUI/avalonia-docs/pull/22
• [x] ThemeDictionaries + ThemeVariants (can be mostly copy pasted from the https://github.com/AvaloniaUI/Avalonia/pull/8166) @maxkatz6
• [x] Fluent and Simple theme documentation. Fluent page must include details about palettes.
• [x] Add proper TopLevel documentation as a separated page (and add links to it from service pages)
• [x] OnPlatform markup extension @maxkatz6
• [x] TextBlock Inlines @Gillibald https://github.com/AvaloniaUI/avalonia-docs/issues/324
• [x] AvaloniaUI/Documentation#27
• [x] Update CompiledBindings page, as most of old issues were solved and it's possible to enable them globally now
• [x] Update supported platforms page. Make sure macOS min supported version fully supports Metal API, as we plan to switch to Metal mid 11.x.
• [x] New controls documentation pages (ColorPicker, DrowDownButton...)
• [ ] Effects API https://github.com/AvaloniaUI/Avalonia/pull/11014 (+ not sure if box shadow was documented before)
• [ ] Document RenderOptions (especially since we have different defaults now) https://github.com/AvaloniaUI/Avalonia/blob/master/src/Avalonia.Base/Media/RenderOptions.cs#L7
• [x] https://github.com/AvaloniaUI/Documentation/issues/438

Nice to have

• [ ] GPU low level interop (see https://github.com/AvaloniaUI/Avalonia/pull/10014) @kekekeks
• [x] Move breaking changes page from the Avalonia repo wiki to the documentation page. Format it properly.
• [x] New events interaction gestures like BackRequested, Holding, pinch.
• [ ] Automation APIs
• [ ] Documentation on custom markup extension (including new OptionsMarkupExtensions)
• [ ] Runtime XAML parsing API which was improved in the 11.0
• [x] Notes about System.Reactive removal?
• [x] https://github.com/AvaloniaUI/avalonia-docs/issues/48
• [ ] https://github.com/AvaloniaUI/avalonia-docs/issues/58
• [x] https://github.com/AvaloniaUI/Avalonia/issues/6960

Won't be added:

• Composition related documentation. It's not considered stable atm, and might have heavy changes during the 11.x timeline.

Something from the 0.10 that really should be documented. Note, there are a lot more missing documentation pages, but I want to mention here major Avalonia features that get lots of questions about.:

• [ ] Control lifecycle (was changed in the 11.0 with Loaded/Unloaded events)
• [ ] NativeControlHost
• [x] Headless API

Existing Documents

• [x] https://github.com/AvaloniaUI/avalonia-docs/blob/9c5df73734f7bb4180d927d2a0d412dbf744f95b/docs/stay-up-to-date/whats-new.md?plain=1#L6
• [x] https://github.com/AvaloniaUI/avalonia-docs/blob/9c5df73734f7bb4180d927d2a0d412dbf744f95b/docs/basics/user-interface/controls/creating-controls/tutorial.md?plain=1#L4
• [x] https://github.com/AvaloniaUI/avalonia-docs/blob/9c5df73734f7bb4180d927d2a0d412dbf744f95b/docs/basics/user-interface/file-dialogs.md?plain=1#L4
• [x] https://github.com/AvaloniaUI/avalonia-docs/blob/9c5df73734f7bb4180d927d2a0d412dbf744f95b/docs/tutorials/music-store-app/index.md?plain=1#L14
• [x] https://github.com/AvaloniaUI/avalonia-docs/blob/9c5df73734f7bb4180d927d2a0d412dbf744f95b/docs/basics/user-interface/adding-interactivity.md?plain=1#L4

Issues from Old Docs Repo

Issues in old repro marked with "Content request":

https://github.com/AvaloniaUI/Documentation/issues?q=is%3Aopen+is%3Aissue+label%3A%22content+request%22

[emmauss]

That's a lot

[ivanjx]

it would be great to have:

• markup declarative docs.
• Native AOT deployment requirements (such as rd.xml etc).

[hez2010]

• Native AOT deployment requirements (such as rd.xml etc).

Avalonia 11 has built-in NativeAOT support, so no rd.xml is needed when you use CompiledBindings everywhere.

[thevortexcloud]

I would also suggest documenting all the various platform specific launch options and how to use them. As far as I am aware it's not mentioned anywhere that they exist.

[maxkatz6]

By launch options do you mean platform options? Like, Win32PlatformOptions.

[thevortexcloud]

Those are the ones. I helped someone awhile back that run into issues with Avalonia overriding things on a Mac. I ended up finding the solution by working backwards from the native interop source code to find the option to disable it.