Add documentation for standalone CAPI Management Cluster

[MaxBed4d]

No description provided.

[sd109]

Nice work @MaxBed4d - thanks for making a start on this! In general I'd like to avoid making these docs specific to SKC wherever possible so I've left a few comments about that in various places. I've also suggested a few corrections on things which aren't necessarily applicable to standalone CAPI management clusters.

[MaxBed4d]

This config should now also include an updated web UI for the docs. It has been tested locally and all the formatting looks to be working correctly.

[JohnGarbutt]

When we last discussed this in platforms, granted a few years back, we were worried on how we maintain these and keep them in-sync with the Azimuth docs.

I don't disagree we need these, but I am hoping we can make it DRY-er vs the existing Azimuth docs.

[JohnGarbutt]

Most of my comments are very small niggles, this is looking pretty good.

I do worry about the resource constraints section... its a very "it depends" sort of a question.

[sd109]

Thanks Max, looking like it's getting better for sure. A few suggestions from me.

[sd109]

@MaxBed4d having taken a step back and looked at the newly added documentation sections, I agree with @JohnGarbutt that there's far too much repetition which will make maintenance and keeping the documentation up to date more difficult than it should be.

I've pushed a modified version of your docs in the latest commit which condenses them down to a single page and focuses much more on what's different in the CAPI-only case while clearly linking to the main Azimuth documentation when relevant rather than repeating information which is already present in the main docs. Let me know what you think or if you feel that I've missed anything important.

[MaxBed4d]

@MaxBed4d having taken a step back and looked at the newly added documentation sections, I agree with @JohnGarbutt that there's far too much repetition which will make maintenance and keeping the documentation up to date more difficult than it should be.

I've pushed a modified version of your docs in the latest commit which condenses them down to a single page and focuses much more on what's different in the CAPI-only case while clearly linking to the main Azimuth documentation when relevant rather than repeating information which is already present in the main docs. Let me know what you think or if you feel that I've missed anything important.

Looks good @sd109, I have made a few minor grammatical changes, but otherwise looks good to go to me!

[sd109]

We should update this admin guide template to refer to these new docs once they're available: https://github.com/azimuth-cloud/azimuth-config/blob/devel/environments/capi-mgmt-example/admin-guide.template.md