docs - Azure docs refactor

[tylergibson]

Several Refactoring actions for Documentation.

1. Simplifying the structure of the Azure Docs to

• Getting Started
• Configuration
• Examples
• Advanced Usage
• Reference

2. Setting up a naming and organization convention for examples

• Uses glob naming suffixes to allow examples to be grouped into multiple categories
• Categories are based on the canonical organization of Azure service offerings
• Examples have a primary focus name prefix to help with alphabetic sorting

3. Moving developer docs into advanced usage, moving Azure Modes into the Functions configuration page.
4. Grouping all core functionality into configuration section - auth, azure functions, and reporting output

Not implemented in this draft PR, but suggestions for further improvements:

1. Getting started should be extended to walk through one end to end scenario showing a developer how to implement all of the core parts of a policy - auth, functions, and reporting.
2. Promoting common filters/actions to top level nodes under Azure and renaming Azure Reference - to create the following Azure menu structure

• Getting Started
• Configure Azure Policies
• Examples
• Common Actions Reference
• Common Filters Reference
• Resources References
• Advanced Usage

3. Ensuring that each example has direct links to the associated actions, filters and resources by hyperlinking within the code block of the example.
4. Ensuring references have links to their relevant examples.
5. Adding an end 2 end scenarios section to the top of the example section for an additional 3-5 most common end to end scenarios.

https://tgibsonblobo.blob.core.windows.net/cloudcustodiandocs/html/index.html

[aluong]

Do you mind throwing the html docs into a SA, so we can browse the changes?

[tylergibson]

Do you mind throwing the html docs into a SA, so we can browse the changes?

https://tgibsonblobo.blob.core.windows.net/cloudcustodiandocs/html/index.html :)

[stefangordon]

This looks awesome! Will take me a bit of time tomorrow to go over it.

[stefangordon]

Really like the nav and examples updates. Just had some comments on content and probably some things for us to think through on install instructions.

[stefangordon]

LGTM but want to wait till after holiday for others to review a few things.

[stefangordon]

Reads a little funny to me ("core concept" of what? ). Not sure we have to repeat this whole paragraph from the index tbh.

I'd just do

Write your first policy
------------------------

Cloud Custodian is a stateless rules engine that filters and takes actions on Azure resources based on policies that you define.

Policies are expressed in YAML and include the following:

...

[stefangordon]

This stateless rules engine bit is already in the paragraphs above (line 11). I'd just drop the sentence and start this with "Cloud Custodian can be bound to serverless event streams across multiple ..."