Skip to main content

Introduction

Welcome to my documentation portfolio

This section of my Docs-as-Code portfolio provides a comprehensive look at technical documentation samples, all authored and published entirely in Markdown using Docusaurus. Here you'll find examples of developer guides, API references, and insights into the workflows used to create them.

Guides

API References

Conceptual/Overview Docs

To view the raw markdown files for these docs, head to GitHub.

Workflow

  • Drafting with Markdown in VS Code
  • Markdown linting with Vale
  • Translation with DeepL
  • Diagram creation with Mermaid
  • Docs versioning with Git
  • API validation with Postman and Swagger/OpenAPI
  • Publishing with Docusaurus

Tools

  • Docusaurus: For generating the static site and documentation.
  • VS Code: Primary editor for all content.
  • Postman: For API testing and generating API documentation examples.
  • Vale: For linting and ensuring style guide adherence.
  • Git/GitHub: For version control and hosting.
  • Mermaid Chart: Converting Mermaid code into images.
  • DeepL: For translation of documentation into multiple languages.

This mirrors how professional teams maintain developer documentation portals such as Docusaurus or similar static-site generators.

Each sample demonstrates end-to-end doc creation: research → drafting → review → publishing.