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+027c9ff9

Netlify build information:

AttributeValue
Netlify builttrue
Date/time12026-09-03 21:09 UTC2
ID6a99e2001cfa2800082bc552
Deploy log6a99e2001cfa2800082bc554
Build contextPR #2791
Deploy contextdeploy-preview
Commit@027c9ff
Branchpull/2791/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.