rethink-public/handbook
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

deploy: whole-flow as plain text, restore v2 diagram shape; admonition variety

Browse Source 
- 'The whole flow' is now plain prose, not an abstract box.
- Restore the v2 diagram shape (git -> staging via develop-if-gitflow AND
  git -> deployment, converging on docker) instead of the linear main-only
  one, keeping the simplified 'libs (rethink-public, pip)' wording.
- Spread admonition types for variety across pages: index agent-callout
  tip -> example; environments uv.lock note -> info; standards logging
  note -> info. (deploy already mixes success/danger/example/warning/tip.)

Verified in-browser: whole-flow reads as text, diagram renders in the v2
shape; mkdocs build --strict clean.

Signed-off-by: disqualifier <dev@disqualifier.me>
This commit is contained in:
dsql
2026-07-01 03:04:51 -04:00
parent 5797248931
commit 350884c2b3
4 changed files with 13 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/deploy.md
+10 -10
View File
@@ -9,11 +9,10 @@
## Preparing for Deploy
!!! abstract "The whole flow"
You build and test locally — leaning on our libraries, AI, and this handbook —
then push a branch and merge to `main`. From there the ops tooling takes over: it
builds the Docker image and runs it on the fleet. **You don't run any deploy
commands** — your only job is the three pieces in the tabs below.
You build and test locally — leaning on our libraries, AI, and this handbook — then
push to git. From there the ops tooling takes over: staging (if you run gitflow), then
it builds the Docker image and runs it on the fleet. **You don't run any deploy
commands** — your only job is the three pieces in the tabs below.
```mermaid
flowchart LR
@@ -29,14 +28,15 @@ flowchart LR
docs --- local
end
build -->|branch| git["git<br/>(Gitea)"]
git --> main["main"]
main --> deploy["deployment<br/>(ops tooling)"]
deploy --> docker["docker<br/>(image built + run on the fleet)"]
build -->|push| git["git<br/>(Gitea)"]
git -.->|develop, if gitflow| stage["staging"]
git --> deploy["deployment<br/>(ops tooling)"]
stage --> deploy
deploy --> docker["docker<br/>(built + run<br/>on the fleet)"]
classDef ship fill:#061541,stroke:#569bcc,color:#eef1f6;
classDef work fill:#0e1530,stroke:#294274,color:#eef1f6;
class git,main,deploy,docker ship;
class git,stage,deploy,docker ship;
class local,libs,ai,docs work;
```