ADR-079 — Help Center and Developer Docs

Architecture decision record — status: Accepted.

Source: docs/adr/ADR-079-help-and-docs-portals.md

ADR-079: Help Center and Developer Docs

Estado

Accepted — 2026-08-23

Contexto

IVPrior separa Help (usuarios de producto) y Developer Docs (contribuidores). DOC-015 los había diferido. El equipo los pide en el scaffold, mismos puertos: Help 3002, Docs 3003.

Decisión

  1. apps/help — Help Center. Locales en y es (ADR-035). Artículos en apps/help/content/{en,es}/{module}/{slug}.md. Audiencia: Owner / Controller / AR specialist.
  2. apps/docs — Developer Docs. Shell /en y /es. Lee markdown del repo (allowlist; una sola fuente). Audiencia: humanos y agentes.
  3. No se mezclan: Help no publica ADRs; Docs no explica “cómo cobrar una invoice” al usuario final.
  4. Sync artículo↔S-xxx es gate (ADR-080, mismo patrón IVPrior ADR-045). Sin pantallas mapeadas el registry puede estar vacío; al existir S-xxx el artículo va en el mismo slice.
  5. Developer Docs (OpenAPI, allowlist, DX) se actualiza en el mismo slice — .specify/memory/dev-docs-content.md.
  6. Sin Fumadocs/Pagefind en V1. Sin apps/mobile.

Consecuencias

  • make local-up levanta help + docs.
  • Briefs con UI P0 MUST incluir Help (ADR-080) y, si tocan contrato/DX, Developer Docs.