129 lines
3.2 KiB
Markdown
129 lines
3.2 KiB
Markdown
# Section 0 Shared Docs -- 0.1.2
|
|
|
|
These documents are available in two ways:
|
|
|
|
1. Read them in AFFiNE.
|
|
AFFiNE is the shared reading and whiteboard space. The Markdown docs from
|
|
this repo appear there as read-only copies.
|
|
|
|
2. Edit them in Git.
|
|
The editable files live in this plain Markdown repo. Use your normal editor,
|
|
then commit and push changes.
|
|
|
|
If you want to change one of these docs, edit the Markdown file. Do not edit
|
|
the AFFiNE copy; it will be refreshed from Git.
|
|
|
|
## What To Edit
|
|
|
|
Edit Markdown files in this Git repo.
|
|
|
|
Current docs:
|
|
|
|
- `README.md`
|
|
- `rta/concept.md`
|
|
- `rta/reports/current-status.md`
|
|
|
|
## First-Time Setup
|
|
|
|
From any machine that can reach the private lab network:
|
|
|
|
```sh
|
|
curl -fsSL http://100.64.0.1:30087/section0/rta-handbook/raw/branch/main/scripts/setup-section0-docs.sh | sh
|
|
```
|
|
|
|
The script clones this repo into:
|
|
|
|
```text
|
|
~/Developer/Section0/rta-handbook
|
|
```
|
|
|
|
It also installs a small helper command at:
|
|
|
|
```text
|
|
~/.local/bin/section0-docs
|
|
```
|
|
|
|
Override the destination if you prefer:
|
|
|
|
```sh
|
|
TARGET_DIR=~/work/rta-handbook \
|
|
curl -fsSL http://100.64.0.1:30087/section0/rta-handbook/raw/branch/main/scripts/setup-section0-docs.sh | sh
|
|
```
|
|
|
|
## Daily Flow
|
|
|
|
```sh
|
|
section0-docs auth login
|
|
section0-docs doctor
|
|
section0-docs pull
|
|
|
|
# Edit Markdown files in your normal editor.
|
|
|
|
section0-docs status
|
|
MESSAGE="Describe the doc change" section0-docs commit
|
|
section0-docs push
|
|
git rev-parse --short HEAD
|
|
```
|
|
|
|
After a push, send Virgil the short commit hash. AFFiNE refresh is handled by
|
|
the lab operator side; collaborators do not need the home-lab repo.
|
|
|
|
## Contributor Setup
|
|
|
|
Anonymous clone/read works on the private lab network. Pushing requires
|
|
Authentik login through the helper.
|
|
|
|
Run this once per checkout:
|
|
|
|
```sh
|
|
section0-docs auth login
|
|
```
|
|
|
|
The login opens Authentik in your browser, configures the Git author from your
|
|
identity, and installs the repo Git credential. After that, normal Git tooling
|
|
works too.
|
|
|
|
Prove write access without changing `main`:
|
|
|
|
```sh
|
|
section0-docs push-test
|
|
```
|
|
|
|
`push-test` does not commit files and does not change `main`. It pushes the
|
|
current commit to a temporary scratch branch, then deletes that branch
|
|
immediately. If Git prompts for a password, use a Gitea access token rather
|
|
than your normal account password. If login is healthy, Git should usually get
|
|
the credential from your local credential store.
|
|
|
|
## End-To-End Smoke Test
|
|
|
|
Use this when setting up a new machine:
|
|
|
|
```sh
|
|
section0-docs pull
|
|
|
|
cd "$(section0-docs open)"
|
|
printf '\nMBP sync smoke test: %s\n' "$(date -Is)" >> rta/reports/current-status.md
|
|
|
|
section0-docs status
|
|
MESSAGE="MBP sync smoke test" section0-docs commit
|
|
section0-docs push
|
|
git rev-parse --short HEAD
|
|
```
|
|
|
|
Send the printed commit hash to Virgil. After the AFFiNE copies are refreshed,
|
|
the smoke line should appear in:
|
|
|
|
```text
|
|
Agent Workspace / Section 0 / Git Projections / RTA Handbook / RTA Status
|
|
```
|
|
|
|
## Source Models
|
|
|
|
This repo is the shared Git model: shared docs are edited in Git, then copied
|
|
into AFFiNE for reading.
|
|
|
|
Personal vault mounts are different: a person keeps custody of their own local
|
|
Obsidian vault and only shares selected Markdown into AFFiNE. See
|
|
`docs/source-models.md` for that more advanced case.
|