changelog.d/5155-docs-schema-5.md
Rama main · réplica de lectura del repositorio original.
- **Docs content schema 5 adds underline, text colour and highlight (#5155).** The colour of both is one of eight palette names (gray, red, orange, yellow, green, blue, purple, pink); the document stores the name, never CSS, and light and dark themes each show their own readable shade. Schema 1-4 documents load, validate and hash unchanged; a document becomes schema 5 only by an explicit `"schema": 5` initialize or the human-only engine upgrade, which now always goes to schema 5. Markdown export writes `<u>`, `<span data-text-color>` and `<mark data-highlight>`; Word export writes native underline, colour and shading. An editor that does not know schema 5 opens such a document read-only with "This document needs a newer editor". Agents still draft only schema 3.
- **Docs schema 5 adds inline dates and mentions (#5155).** A date is one calendar day (`YYYY-MM-DD`); a mention stores only the person's user id. Names are resolved for each reader by `GET /api/v1/pages/{slug}/document/people` (CLI `crewship doc people`), which names only people who can read the document and only to someone who can read it; every other id appears as Unknown member, so the answer never confirms that an id exists. Markdown and Word export write the date and `@name`.