Docs
Available Collections
Documentation domains currently integrated in this portal.
What Are Collections?
Collections are groups of documentation sourced from different repositories. Each collection maps to a top-level section in the navigation and has its own URL prefix.
Collections are defined in collections.ts and can be either:
- Bundled — Markdown files within this repository (e.g.,
docs) - Remote — Markdown files fetched from GitHub repositories at build time
Active Collections
Docs (this portal)
| Property | Value |
|---|---|
| Source | Local (content/docs/) |
| URL prefix | /docs |
| Purpose | Portal documentation — how to use, contribute, and integrate with this site |
Engineering Handbook
| Property | Value |
|---|---|
| Source | ontopix/engineering-handbook |
| URL prefix | /engineering |
| Purpose | Development standards, workflows, tooling decisions, and technical guidelines |
Schemas
| Property | Value |
|---|---|
| Source | ontopix/schemas |
| URL prefix | /schemas |
| Purpose | Data schemas and type definitions used across Ontopix services |
Audit Utils
| Property | Value |
|---|---|
| Source | ontopix/audit-utils |
| URL prefix | /auditutils |
| Purpose | Audit utilities documentation for tracking and logging |
Stylebook
| Property | Value |
|---|---|
| Source | ontopix/stylebook |
| URL prefix | /stylebook |
| Purpose | Design system documentation — components, tokens, patterns, and visual guidelines |
Planned Collections
The following collections are planned for future integration:
| Collection | Domain | Status |
|---|---|---|
| Infra | Infrastructure | Planned |
| Legal | Legal guidelines and compliance | Planned |
| Marketing | Brand guidelines and marketing resources | Planned |
| Architecture | System architecture and technical decisions | Planned |
Each planned collection will follow the same pattern: documentation lives in its own GitHub repository and is pulled into this portal via collections.ts.
Adding a New Collection
See the Collection Architecture page for the technical details, or the Contributing section for step-by-step instructions.