Skip to content

Commit cd32101

Browse files
codekilnclaude
andcommitted
docs: expand alias guide and dotfiles-garden connection note
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent d214891 commit cd32101

2 files changed

Lines changed: 14 additions & 7 deletions

File tree

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,14 @@
1-
## `alias::` for more convenient or alternate names
1+
# `alias::` for more convenient or alternate names
22
- 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]]`.
33
- 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.
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
11
- My dotfiles are connected to this knowledge garden (logseq-encode-garden).
2-
- I want my dotfiles to be as self-explanatory as possible, but have the dependencies of my dotfiles documented in my garden. Therefore I have the technologies and dependencies declare their [[logseq-url]]
2+
- I want my dotfiles to be as self-explanatory as possible. That said, pretty much every technology I use is one I do not understand completely, and this knowledge garden is my system for learning things about technology.
3+
- Therefore I aspire to converge upon the invariant that the technologies and dependencies in my dotfiles should declare in code comments a [[logseq-url]] to the logseq-encode-garden page pointing to the [[Logseq/Entity]] page in this garden where I'm learning about and keeping track that software project or plugin or whatever.

0 commit comments

Comments
 (0)