Files
memos/docs/design
boojack f22b30f5c0 refactor(demo): seed content after the configuration apply
Startup is now migrate, apply the configuration, then seed in demo mode,
the order in which comparable systems bootstrap identity before content.
Seed leaves store.Migrate and becomes a method the server calls after
applyConfigurationAtStartup.

The seed holds content only. The public demo access token and the
MEMO_RELATED row are gone; the reaction list belongs to the configuration.
Users are inserted without fixed ids and only when missing, their profile
fields are filled only where empty, and every memo, membership, reaction,
and attachment references its creator by username. A declared
administrator therefore keeps its row, credentials, and display name, and
the seeded content attaches to it. A bare --demo start without a
configuration seeds the same four users as before.

The seed test covers both starts and asserts the seed writes no instance
or user settings. Two stale lines of copy are fixed.
2026-10-31 13:33:36 +08:00
..

Design Documents

A design document records a decision and the reasoning behind it. Source code, tests, and package README.md or doc.go files describe current behavior; a design document does not have to.

Lifecycle

  • Draft. A design that is not yet shipped in a tagged release may change freely, even after its code is merged. Keep it in step with the implementation until the release, because the design itself often changes while a feature settles.
  • Implemented. Once the feature ships in a release, set Status: Implemented and freeze the body. Do not edit it to track later code changes.
  • Amendments. When a later release changes a frozen design, add or extend a dated ## Amendments section at the end that states what changed and why. Leave the original body intact, so the original rationale stays readable. A change large enough to need its own rationale gets a new design document that links back to the one it replaces.

Index

Drafts, merged but not yet released:

Drafts, implemented but not yet merged:

Implemented and frozen: