|
1 | | -## `alias::` for more convenient or alternate names |
| 1 | +# `alias::` for more convenient or alternate names |
2 | 2 | - In Logseq, if page `[[Super Long Name]]` has frontmatter `alias:: [[Shortname]]`, then clicking on `[[Shortname]]` in the wiki will take you to page `[[Super Long Name]]`. |
3 | 3 | - It is appropriate and useful for making note of real alternate names, plural or contextual link surfaces, handles, acronyms, and other useful discovery forms. |
4 | | - - By default, this garden tries to use the singular form for the canonical page name, and may use alias for the plural form. |
5 | | - - Canonical page names should remain singular where the garden naming convention calls for singular names; plural or contextual references belong in aliases. |
6 | | - - Do not create an alias that only repeats parent namespace context already expressed by the page title. |
7 | | - - Aliases are human-curated, not agent-generated. Agents should suggest alias candidates in the chat response rather than writing them to the page without explicit instruction. |
8 | | - - When auditing or pruning aliases, verify each with `rg '[[Candidate Name]]' pages/ journals/` to check graph usage before keeping it. For a graph-wide audit, [[nbb-logseq]] is more appropriate than ad hoc text search. |
| 4 | + - ## Aliases are human-curated, not agent-generated |
| 5 | + - Agents should suggest alias candidates in the chat response rather than writing them to the page without explicit instruction. |
| 6 | + - ## Do not proliferate many aliases, be judicious |
| 7 | + - Every alias added to the graph slows down the auto-complete time and potentially confuses the human operator as to which is the "canonical" version. |
| 8 | + - ## Use Aliases for Plural Forms |
| 9 | + - By default, this garden tries to use the singular form for the canonical page name, and may use alias for the plural form. |
| 10 | + - Canonical page names should remain singular where the garden naming convention calls for singular names; plural or contextual references belong in aliases. |
| 11 | + - ## Do not be redundant with aliases |
| 12 | + - Do not create an alias that only repeats parent namespace context already expressed by the page title. |
| 13 | + - ## Searching for Aliases |
| 14 | + - When auditing or pruning aliases, verify each with `rg '[[Candidate Name]]' pages/ journals/` to check graph usage before keeping it. For a graph-wide audit, [[nbb-logseq]] is more appropriate than ad hoc text search. |
0 commit comments