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
@@ -46,13 +46,10 @@ Commit after each dispatch, cross-cutting chunk of work, or batch of inline answ
|
||||
|
||||
In `diwan.org` at the repo root, under a top-level "Reports" heading (create the file and heading if this is the very first tick), first delete any existing report subheadings already marked `[X]` in their title — Marc has read those, they're disposable, don't let them pile up (this applies to every entry regardless of who wrote it, including ones a `do` session appended). Then add one new subheading per notable thing *this tick itself* did — a new dispatch, an inline answer, a batch of triage moves, not one giant entry covering the whole run, and not anything that happened inside an active `do` session's own subtree (that session reports its own work, see PROTOCOL.md's Reports section — a bare nudge you sent this run is explicitly not reportable by you). Keep titles short enough that Marc can skim the whole log collapsed and know what happened without opening anything. Each entry:
|
||||
|
||||
** [ ] <short title>
|
||||
:PROPERTIES:
|
||||
:LINK: <fuzzy heading or id: link to the one heading this is about, if there is one>
|
||||
:END:
|
||||
** [ ] [[<fuzzy heading or id: link to the one heading this is about>][<short title>]]
|
||||
[diwan YYYY-MM-DD] <one or two lines, no more>
|
||||
|
||||
Omit the `:LINK:` property when there's no single heading the entry is about (e.g. "nothing to triage this run"). Anything needing Marc's actual input or a reply (as opposed to a passive FYI) belongs as a normal unread entry in the relevant heading's own `:chat:`, not in the report — the report entry may link there, but don't try to hold a conversation in it.
|
||||
Make the title itself the link — no `:LINK:` property, no properties drawer. Leave the title as plain text (no link) when there's no single heading the entry is about (e.g. "nothing to triage this run"). Anything needing Marc's actual input or a reply (as opposed to a passive FYI) belongs as a normal unread entry in the relevant heading's own `:chat:`, not in the report — the report entry's title or body may link there, but don't try to hold a conversation in it.
|
||||
|
||||
Commit: `tick: report`.
|
||||
|
||||
|
||||
Reference in new issue
Block a user