Skip to main content

Conventions

Conventions

Files

  • Markdown, UTF-8, LF line endings.
  • One topic per file; the filename is the topic, not a date. Dates belong in frontmatter or journal headings.
  • Folders are numbered so they sort in a fixed order. Do not add new top-level folders without a reason; use 00-inbox/ if unsure.
  • Wikilinks ([[note]]) for notes inside the brain, normal relative links for things outside it.
  • No credentials. Point at Passwords.kdbx, .env or the secret store.

Frontmatter

---
title: Human title
updated: YYYY-MM-DD
tags: [systems, mail]
---

Only title, updated and tags are required. Extra fields are fine when they help a query (e.g. host, repo, status).

Journal entries

Newest first. Each entry: Symptom → Root cause → Fix → Prevention → Lessons, with exact paths, commands, hosts and dates. Append-only.

Decisions

One entry per settled choice: date, decision, alternatives rejected, why, and what changes as a result. If a decision is later reversed, add a new entry rather than editing the old one.

Commits

git add -A && git commit -m "<area>: <summary>"

Areas: journal, systems, projects, reference, meta.

Back to top