Description
What type of issue is it? (Choose one - delete the others)
Missing documentation
Describe the issue
We have in the community package team been talking about the current documentation for building extensions in v14. And the agreement is that the new backoffice is pretty well-covered by reference documentation (and it seems the Backoffice team is still working on improving it).
What we feel is missing is more realworld tutorial style documentation like https://docs.umbraco.com/umbraco-cms/tutorials/creating-a-property-editor & https://docs.umbraco.com/umbraco-cms/tutorials/creating-a-custom-dashboard that takes people the whole way through new concepts and allows them to piece different parts together.
We've come up with a few examples of tutorials that could be an idea and what parts they would cover:
Tutorial ideas:
Reading data from a separate property editor
- Set up fx a contentment data list picking a category
- Set up a custom property editor that reads the selected categories from the first and allows selecting multiple products filtered to the selected categories
Covers:
- Generate TS client to get product data from own API
- Read data from another property editor (something which is very hard in 13 and lower)
- Reusing the uui component for input fields
- Opening modals and passing data back to the view
Dashboard that displays the audit log (or some other management api data stream)
- Will list audit log entries in a listview
- When selecting one it opens up in a big modal with all the relevant information
Covers
- Pulling data from the management api
- Routable modals for deeplinking
- Rendering a listview uui component
- Doing pagination on a listview uui component
We feel that these will supplement the current tutorials quite well, as well as introduce some new concepts that were not possible before in the AngularJS driven backoffice (reacting to the value of a separate property editor & deep linking modals).