- Should explicitly spell out the value of Big Bang in terms a Non technical PM can understand.
- Engineer who has never seen Big Bang before should be able to get a concrete understanding of Big Bang via:
- Architecture Diagram(s) needed to understand overview should exist here
...
...
@@ -17,7 +17,7 @@
- A link + description of this should live in the root README.md of the [BB UHC Repo](https://repo1.dso.mil/platform-one/big-bang/bigbang).
- This should live in /docs/overview.md of the [BB UHC Repo](https://repo1.dso.mil/platform-one/big-bang/bigbang).
2. Big Bang Quick Start Demo, Code, and Docs:
### 2. Big Bang Quick Start Demo, Code, and Docs:
- This should have example code + user friendly spell it out for me documentation that a random DoD Service member with little to no prior knowledge of Docker / Kubernetes, but access to hardware or a cloud account can use to spin up Big Bang Demo from scratch with minimal intervention.
- This should live in a [quickstart repo](https://repo1.dso.mil/platform-one/quick-start/big-bang)
A Nice thing about docs living in another repo is that we can be more lax when it comes to giving team members rights to a documentation repo / we can allow anyone on the team to review anyone elses MR before commiting instead of requiring only code owners to approve.
...
...
@@ -26,10 +26,10 @@
- An Architecture Diagram of how the quickstart works / leverages k3d should exist
- Besides CI, this is the only place where non production demo hack type documenetation should exist. So shortcuts like using docker flux, not using a git repo to inject the BB UHC input helm values, using personal registry1 creds vs Iron Bank Robot Credential can exist here.
3. Post Installation Package Configuration Docs:
### 3. Post Installation Package Configuration Docs:
- Should exist in the repo of each individual package, and a documentation server hosted on BigBang as outlined [here](https://repo1.dso.mil/platform-one/big-bang/bigbang/-/blob/master/charter/PackageDocumentation.md).
4. Internet Connected Production Deployment Docs:
### 4. Internet Connected Production Deployment Docs:
- This should have BB Residency level of detail
- The customer template repo https://repo1.dso.mil/platform-one/big-bang/customers/template
Should be renamed and moved to https://repo1.dso.mil/platform-one/big-bang/deployments/bb-internet-connected
...
...
@@ -37,12 +37,12 @@
A Nice thing about docs living in another repo is that we can be more lax when it comes to giving team members rights to a documentation repo / we can allow anyone on the team to review anyone elses MR before commiting instead of requiring only code owners to approve.
- A link + description of this should live in the root README.md of the [BB UHC Repo](https://repo1.dso.mil/platform-one/big-bang/bigbang).
5. Internet Disconnected Production Deployment Docs:
### 5. Internet Disconnected Production Deployment Docs:
- This would be where the BB Airgap solution team would store code and docs for the BB official upstream airgap deployment solution.
- Should exist here https://repo1.dso.mil/platform-one/big-bang/deployments/bb-internet-disconnected
A Nice thing about docs living in another repo is that we can be more lax when it comes to giving team members rights to a documentation repo / we can allow anyone on the team to review anyone elses MR before commiting instead of requiring only code owners to approve.
- After it's stable a link + description of this should live in the root README.md of the [BB UHC Repo](https://repo1.dso.mil/platform-one/big-bang/bigbang).
5. Developer Contribution Docs:
### 6. Developer Contribution Docs:
- Only the latest version matters, and maybe improving docs around developer environment / process / doing things like updating a broken link should be allowed to be added to a master document faster / not go through the same level of scrutiny as a code merge where only Josh/Tom can accept it. Maybe it could exist in the [wiki?](https://repo1.dso.mil/platform-one/big-bang/bigbang/-/wikis/developer/developer-documentation) and the BB Charter could link to the wiki so it'd still be readily discoverable.
- Otherwise this should should exist in BB Charter. (needs discussion)
