[FEATURE] Generated documentation Settings Catalog in readable format

[snodecoder]

Is your feature request related to a problem? Please describe.
The generated documentation for Settings Catalog policies is hard to read. It now shows an odata setting type in non human readable format.

Describe the solution you'd like
I would like to extract the meaningful name of the setting and it's value together with a description of the setting and show them in a Configuration table in the markdown documentation.

Describe alternatives you've considered
I've looked at how another project (IntuneManagement) handles this, and I'am currently working on a pull request for this.

Additional context
Improving the readability of Intune policy Settings is like going down the rabbit hole, but for Settings Catalog policies this is doable. I'am currently quite far with a working solution and will share the pull request once I'am satisfied :)

[snodecoder]

Example of generated documentation before changes:

Example of generated documentation after changes:

[snodecoder]

I've got this working now for Settings Catalog, but need to fix the documentation formatting of the other objects/policies.
Besides from a minor formatting bug, the generated documentation for the other objects/policies looks good!
I'll prepare a pull request for you to review @almenscorner

[snodecoder]

Added pull request for this with the changes #245

[snodecoder]

Just fixed 1 last bug that occured during updating Intune from backuped JSONs. I added a non-graph custom property to settingdefinitions during backup for displaying the root category in documentation which caused updating a policy in intune to fail. I've fixed this in BaseUpdateModule

[Nouneds]

Any news when this update will be pulled?

[almenscorner]

Hi,

I have not had the time to review this as it is a very substantial change that is also changing some core functionality. I will try and find time over the coming weeks but it might take some time.