Docs reorg
Summary Docs Reorg Part 1 of N
This isn't done done, but I want to avoid a water fall merge, and do the doc reorg over time.
This is at a good enough checkpoint that it should be reviewable & mergeable.
The remaining reorg of .md files in the /docs folder can be done over time
(I'd like to make it so only a README.md exists there and use it as the primary entry point.)
Use this to preview: https://repo1.dso.mil/platform-one/big-bang/bigbang/-/tree/doc-reorg/docs
Summary of Changes:
- Added a Main README.md
- Renamed /docs/understanding to /docs/understanding_bigbang
- Added a /guides/deployment_scenarios/quickstart.md as scaffolding to help others get idea of where to org docs in future
- Moved contents of /docs/d_prerequisites.md to /docs/guides/prerequisites
- Deleted /docs/c_faqs.md that was empty
- Added /docs/understanding_bigbang/README.md with Useful Background Contextual Info
- Jon added Flux install docs from the cohort
- Added further elaboration on OS, kube distro, and storage class prequisites, and created a table to clarify and set expectations that different deployment scenarios result in different prerequisites.
Hot Spots I know I can use feedback on:
- (.md links could use testing as well)
- (the prereqs table)
Edited by Christopher McGrath