20 docs tagged with "documentation"

Decision to use Docusaurus as the docs-as-code platform for the portfolio documentation system.

Decision to keep the Portfolio App focused on a polished product experience and use the Docusaurus Documentation App as the enterprise evidence engine.

Governance for features that integrate documentation and evidence workflows.

Direct links from the app to dossiers, ADRs, and runbooks.

Explicit guidance to lead reviewers to the evidence trail.

Comprehensive guide for creating consistent, accessible Mermaid diagrams across portfolio documentation.

Summarize post-Phase 6 changes across portfolio-app and portfolio-docs, focusing on testing depth, feature catalog coverage, and documentation standards.

What the Portfolio Docs App is, why it exists, and what it proves — plus the minimum viable enterprise outcomes and evidence expectations.

Security posture for the Portfolio Docs App: threat surface, enforceable SDLC controls, supply chain hygiene, and public publication safety.

Quality model for the Portfolio Docs App: build integrity, broken-link failures, lint/format gates, and reviewer-facing validation checks.

Common failure modes for the Portfolio Docs App and deterministic fixes: build failures, broken links, category issues, routing confusion, and MDX errors.

How to use this Docusaurus repository as an enterprise-grade, docs-as-code evidence system for the portfolio web app and linked demo projects.

Enterprise-style roadmap for building the Portfolio App (Next.js/TypeScript) and its supporting evidence ecosystem (Docusaurus), with phased deliverables and governance artifacts.

Enterprise-grade documentation system built with Docusaurus to serve as the portfolio’s evidence and governance platform.

Standardized, repeatable project documentation packages for the portfolio app and each demo project, organized for fast review and deep technical validation.

Procedure to diagnose and fix pnpm build failures caused by broken internal links, missing doc IDs, or category link mismatches.

Procedure to deploy the Portfolio Docs App via PR workflow, including validation steps and rollback triggers.

Procedure to rollback a Portfolio Docs App deployment by reverting changes on main and validating recovery.

Deep dive guidance for writing, reviewing, and maintaining high-value code commentary.

Threat model for the Docusaurus documentation platform, focused on supply chain risk, CI integrity, public content safety, and deployment surface controls.