mhoennigandClaude Opus 5
29a217f892
Zuhause ist künftig git.javagil.de/mi/werkbaum (origin); GitHub bleibt unter dem Remote `github` ein Klon, den scripts/push-github.sh mit `main` versorgt — nur vorwärts, nie erzwungen. Der Klon bleibt aus zwei gemessenen Gründen: Gitea sendet auf raw-Dateien kein Access-Control-Allow-Origin (nachgemessen an mi/werkdock), die ?sourceUrl=-Beispiellinks der READMEs müssen also auf raw.githubusercontent.com zeigen; und der Pages-Workflow lässt sich nicht mitnehmen. Footer, llms.txt und llms.md zeigen jetzt auf Gitea (Repo-Seite ohne Anmeldung lesbar, HTTP 200 geprüft); beide COMMIT_URL-Stellen (deploy-prod.sh und der Pages-Workflow) ziehen mit. deploy-prod.sh prüft origin und github getrennt und erinnert an das Spiegeln, statt selbst zu pushen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
34 lines
1.6 KiB
Plaintext
34 lines
1.6 KiB
Plaintext
# Werkbaum
|
|
|
|
> A plain-text notation for work breakdown structures (WBS) with and/or
|
|
> decomposition, plus a browser editor that renders it as a diagram. This file
|
|
> is an index; the notation itself is explained in the guide linked below.
|
|
|
|
A Werkbaum plan is ordinary UTF-8 text, one node per line. Indentation carries
|
|
the hierarchy, and the leading character says how the children relate: `-` all
|
|
required, `+` an optional extra, `|` alternatives, `=` exactly one of them. A
|
|
checkbox such as `[x]` gives the status, `(M)` the T-shirt size. Nothing else
|
|
is needed to store, share or version a plan.
|
|
|
|
## Docs
|
|
|
|
- [Notation guide](https://werkbaum.javagil.de/llms.md): Everything needed to
|
|
read and write the notation, in English: line format and extraction order,
|
|
gates, status codes and progress ranks, sizes, node ids, dependencies,
|
|
folding marks, descriptions, plus a complete example. Self-contained; start
|
|
here.
|
|
- [Specification](https://git.javagil.de/mi/werkbaum/src/branch/main/docs/SPEC.md):
|
|
The normative language definition (German). Where it and the guide disagree,
|
|
it wins.
|
|
- [Editor](https://werkbaum.javagil.de/): Renders a plan as a diagram.
|
|
`?sourceUrl=<url>` loads any CORS-readable http(s) text file, and
|
|
`?etherpad=<pad-url>` follows a live Etherpad.
|
|
|
|
## Optional
|
|
|
|
- [Design decisions](https://git.javagil.de/mi/werkbaum/src/branch/main/docs/DECISIONS.md):
|
|
Why the notation looks the way it does, at length (German). Background only,
|
|
not needed to read or write plans.
|
|
- [Repository](https://git.javagil.de/mi/werkbaum): Source and example plans
|
|
under `docs/examples/*.werkbaum`.
|