Skip to content

Refactor documentation structure: consolidate internals page - #454

Merged
ocots merged 5 commits into
mainfrom
refactor/docs-structure
Jun 21, 2026
Merged

Refactor documentation structure: consolidate internals page#454
ocots merged 5 commits into
mainfrom
refactor/docs-structure

Conversation

@ocots

@ocots ocots commented Jun 21, 2026

Copy link
Copy Markdown
Member

This PR refactors the documentation structure to consolidate internal symbols into a single "Internals" page and adjusts heading levels for better hierarchy.

Changes

docs/api_reference.jl

  • Replaced individual documentation pages for extensions (DocumenterReference, CoveragePostprocessing, TestRunner) with a single consolidated "Internals" page
  • Used a configuration-driven approach for public API pages (Core, Descriptions, Exceptions, Unicode, DevTools)
  • All private symbols from extensions are now grouped in one page with sections by module

ext/DocumenterReference/page_building.jl

  • Adjusted heading levels: module symbols now use ### instead of ## to create proper hierarchy under module headers
  • Module section headers in private/public pages use ## instead of ### for better visual structure

Benefits

  • Simpler documentation structure with fewer top-level pages
  • Better visual hierarchy with consistent heading levels
  • Easier maintenance through configuration-driven approach
  • All internal APIs are now discoverable in one place

ocots and others added 4 commits June 21, 2026 14:28
…fallback + backend docs

- Remove test/README.md and docs/README.md (content absorbed into dev/)
- dev/RULES.md: add MCP fallback (§1), new Coverage section (§2), build
  command + local preview subsections (§3), update checklist
- dev/philosophy/documentation.md: add Backend section (Documenter.jl vs
  DocumenterVitepress), update layout tree with .vitepress/
- dev/PHILOSOPHY.md, dev/PLAN.md: renamed/moved from philosophy/ root

Co-Authored-By: Cascade <cascade@codeium.com>
…/CLAUDE

- Remove dev/ directory (moved to control-toolbox/Handbook)
- AGENTS.md: rewrite with generic layout, redirect Developer Resources to Handbook
- CLAUDE.md: identical to AGENTS.md
- README.template.md: enhance description of CTBase's foundational role
- Add README.md in src/, ext/, test/, docs/ with package-specific context
- All point to control-toolbox Handbook for conventions

Co-Authored-By: Cascade <cascade@codeium.com>
@ocots
ocots merged commit c994dfa into main Jun 21, 2026
4 checks passed
@ocots
ocots deleted the refactor/docs-structure branch June 21, 2026 13:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant