Support @-mentioning a document for target_doc in App Config instead of a raw doc id #55

New issue

Open

opened 2026-07-24 19:43:02 +02:00 by cloudbot · 0 comments

cloudbot commented

2026-07-24 19:43:02 +02:00

Collaborator

Goal

When authoring a template's ## App Config table in Outline, allow target_doc to be set by @-mentioning the target document (Outline's native document-mention feature) instead of pasting a raw document id/UUID. The App Config table should then show a live, clickable link to the target document rather than an opaque id string.

Motivation

Currently target_doc is a plain id string with no visible link back to the document it points to — there's no way to see or verify what it references without leaving the template and looking the id up separately. A live mention would make the App Config table self-documenting and let authors set the target by picking the doc directly in Outline's UI.

Acceptance criteria

target_doc in App Config can be set via an Outline document mention (rendered as a live link in the template body)
TemplateParser resolves the document id out of the mention syntax the same way it currently reads the raw id string
Existing templates using a raw doc id string for target_doc continue to parse without changes (backward compatible)
The App Config table, when viewed in Outline, shows a clickable link to the target document

Non-goals / constraints

Not changing how target_doc is used for standalone-mode collection ids — only the append-mode "document to append into" case, unless a mention resolves cleanly to a collection reference too
Must not break existing templates authored with a plain id string

Builds on the target_doc handling introduced in #24/#27 (App Config parsing, TemplateParser, EntryTargetResolver).

## Goal When authoring a template's `## App Config` table in Outline, allow `target_doc` to be set by @-mentioning the target document (Outline's native document-mention feature) instead of pasting a raw document id/UUID. The App Config table should then show a live, clickable link to the target document rather than an opaque id string. ## Motivation Currently `target_doc` is a plain id string with no visible link back to the document it points to — there's no way to see or verify what it references without leaving the template and looking the id up separately. A live mention would make the App Config table self-documenting and let authors set the target by picking the doc directly in Outline's UI. ## Acceptance criteria - [ ] `target_doc` in App Config can be set via an Outline document mention (rendered as a live link in the template body) - [ ] `TemplateParser` resolves the document id out of the mention syntax the same way it currently reads the raw id string - [ ] Existing templates using a raw doc id string for `target_doc` continue to parse without changes (backward compatible) - [ ] The App Config table, when viewed in Outline, shows a clickable link to the target document ## Non-goals / constraints - Not changing how `target_doc` is used for standalone-mode collection ids — only the append-mode "document to append into" case, unless a mention resolves cleanly to a collection reference too - Must not break existing templates authored with a plain id string ## Related Builds on the `target_doc` handling introduced in #24/#27 (App Config parsing, `TemplateParser`, `EntryTargetResolver`).

cloudbot added the

feature

label

2026-07-24 19:43:02 +02:00

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

utilities/Logbook#55

No description provided.

Rows
Columns