Reports: make the entry title itself the link, drop :LINK: property
A report subheading's title is now the link to the heading it's about (org [[target][description]] syntax, description = the short title), instead of a separate :LINK: property in a properties drawer. Plain text title when there's no single heading to link. Further links, if needed, go inline in the signed body.
This commit is contained in:
1 parent
18c8284349
commit
b9d1f96563
4 files changed
+6
-12
No files matched your search
+2
-5
@@ -73,14 +73,11 @@ diwan's own operational file, at the root of the content repo — not a place fo
|
||||
|
||||
Every notable thing a diwan agent does — a tick dispatching something new, a tick triaging a batch of inbox items, a `do` session finishing a real piece of work — gets its own short subheading under the top-level "Reports" heading in `diwan.org`. One entry per notable thing, not one giant paragraph per run: this is what keeps each entry short and the whole log skimmable with everything collapsed. **Whoever actually did the thing writes the entry** — `diwan tick` reports its own actions (triage moves, inline answers, promotions, new dispatches), and a `diwan do` session reports its *own* progress once it has something worth telling the user, not before. In particular: a tick merely nudging an idle active session (see the `:session:` section above) is not itself reportable — tick has no idea yet whether anything came of it, so it stays silent; if the nudge leads the session to actually do something, that session writes the entry once it has.
|
||||
|
||||
Format: a `[ ]`/`[X]` checkbox right in the subheading title (same pattern as `Close diwan session`), a short title, an optional `:LINK:` property pointing at the one heading the entry is most about (fuzzy heading link, or `id:` link for a note file with an `:ID:` drawer — skip it if there's no single heading to point at), and a signed one-or-two-line body, no more:
|
||||
Format: a `[ ]`/`[X]` checkbox right in the subheading title (same pattern as `Close diwan session`), a short title that *is itself the link* to the one heading the entry is most about (fuzzy heading link, or `id:` link for a note file with an `:ID:` drawer — just plain text with no link if there's no single heading to point at), and a signed one-or-two-line body, no more. No `:LINK:` property, no properties drawer at all — any further links belong inline in the body text:
|
||||
|
||||
```org
|
||||
* Reports
|
||||
** [ ] Dispatched kitchen redecoration
|
||||
:PROPERTIES:
|
||||
:LINK: [[file:personal.org::*Plan the kitchen redecoration][Plan the kitchen redecoration]]
|
||||
:END:
|
||||
** [ ] [[file:personal.org::*Plan the kitchen redecoration][Dispatched kitchen redecoration]]
|
||||
[diwan 2026-11-08] Non-trivial, dispatched as do-kitchen.
|
||||
** [X] Triaged 2 inbox items
|
||||
[diwan 2026-11-07] Moved into esdeveniments.org and personal.org.
|
||||
|
||||
Reference in new issue
Block a user