A public, non-proprietary portfolio showing how I build documentation as a product: information architecture, developer-focused writing, docs-as-code workflows, API documentation, and AI-assisted documentation governance.
Live site: https://luisjguedes.github.io/docs-portfolio/
- docs-portfolio - the front door for documentation samples and working style
- docs-ai-operating-model - flagship AI DocsOps project: quality gates, PromptOps, governance, and evaluation for AI-assisted documentation
- openapi-to-human-reference - API documentation transformation from OpenAPI contract to human-readable Markdown reference
- docsops-quality-gate - reusable PR quality gate for documentation linting, link checks, terminology, and scorecards
- Structured docs: concept, how-to, reference, and troubleshooting patterns
- Docs-as-code: Markdown + MkDocs Material with CI checks in GitHub Actions
- Quality guardrails: Microsoft-aligned style linting with Vale
- AI DocsOps: quality gates, PromptOps, governance, and evaluation model for AI-assisted documentation
- API documentation sample using OpenAPI (
api/openapi.yaml) - Diagramming sample using Mermaid
All content is generic and created for portfolio purposes only. No employer, customer, or confidential material is included.
- LinkedIn: https://www.linkedin.com/in/luisjguedes/
- Email: luisjguedes@gmail.com