Project and website documentation

Architecture and maintainer workflows for the Docsy theme and website

This section is for Docsy maintainers and contributors.

Section under construction.

Content (planned)

Planned content organization (tentative):

  • About: High-level information about the project, including its purpose, ownership, and overall status.
  • Design: Architectural design, Information Architecture (IA), layout, UX choices, theme related decisions and conventions, and other design-level artifacts.
  • Implementation: Code-level structure, Hugo/Docsy templates, SCSS/JS customizations, patches, and internal shims.
  • Build: Tooling, local development setup, CI/CD workflows, deployment environments, and automation details.
  • Quality: Tests, link checking, accessibility standards, and review practices.
  • Roadmap: Milestones, backlog, priorities, technical debt, and design/implementation decisions.

Site build information

Docsy version: v0.17.1-dev+eac87587

Netlify build information:

AttributeValue
Netlify builttrue
Date/time12026-09-09 16:31 UTC2
ID6aa189c6318e0000080be7a1
Deploy log6aa189c6318e0000080be7a3
Build contextPR #2799
Deploy contextdeploy-preview
Commit@eac8758
Branchpull/2799/head

  1. Approximate build timestamp. ↩︎

  2. In your timezone: unknown↩︎


About the project

High-level information about the project, including its purpose, ownership, and overall status.

Design

Design decisions and conventions for the Docsy theme

Build

Tooling, local development setup, CI/CD workflows, deployment environments, and automation details.

Implementation

Code-level structure, Hugo/Docsy templates, SCSS/JS customizations, patches, and internal shims

Quality

Tests, link checking, accessibility standards, and review practices

Repository-root markdown files

Repository-root pages for the Docsy project.

Style guide

Writing and formatting conventions for Docsy project documentation.