Vishesh 'ironeagle' Bangotra
a32eeaf2b4
- collect.py copies each repo's built site contents directly to a top-level <repo>/ dir (was libs|apis|wiki/<repo>/site nesting) - nginx uses `index index.html lib/index.html api/index.html` so /dagpipe/ -> lib/index.html, /auth-server/ -> api/index.html are served internally with no redirects - _index regenerates links against the flat layout (/dagpipe/lib/, /auth-server/api/, /mongo-ops/, /blog/...) - config.yml static entries point at vendored blog/ + media-manager/ - Dockerfile copies per-repo dirs flat into the nginx html root - removed stale libs/, apis/, wiki/, tutorials/ category trees
101 lines
3.4 KiB
YAML
101 lines
3.4 KiB
YAML
# aetos-docs configuration
|
|
# Single source of truth for which repositories the docs service serves.
|
|
#
|
|
# repos: documentation collected from sibling source repositories via collect.py
|
|
# (refreshed manually: run `python collect.py` after rebuilding each repo's docs)
|
|
# static: docs already vendored inside this repository (never collected)
|
|
#
|
|
# Each repo may provide any of the doc kinds: lib, api, wiki (web sites) and mcp (MCP bundle).
|
|
# Served layout (flat, one dir per repo; no redirects):
|
|
# lib -> /<repo>/lib/
|
|
# api -> /<repo>/api/ (or /<repo>/ when the site has a root index.html)
|
|
# wiki -> /<repo>/
|
|
# mcp -> MCP server on its configured port
|
|
|
|
service:
|
|
name: aetos-docs
|
|
html_port: 9000 # nginx: html portal
|
|
health_port: 8000 # mcp: /healthz
|
|
|
|
repos:
|
|
- name: openapi-first
|
|
source: ../openapi-first
|
|
title: OpenAPI First
|
|
description: Design-first API development toolkit enforcing OpenAPI contracts as the single source of truth.
|
|
docs:
|
|
lib: site
|
|
mcp: { bundle: docs/mcp, server: openapi_first, port: 8004 }
|
|
|
|
- name: doc-forge
|
|
source: ../doc-forge
|
|
title: Doc Forge
|
|
description: Renderer-agnostic Python documentation compiler powering MkDocs and MCP generation across Aetoskia projects.
|
|
docs:
|
|
lib: site
|
|
mcp: { bundle: docs/mcp, server: docforge, port: 8001 }
|
|
|
|
- name: dagpipe
|
|
source: ../dagpipe
|
|
title: DAG Pipe
|
|
description: Deterministic pipeline framework for executing state transformations through a directed acyclic graph (DAG).
|
|
docs:
|
|
lib: site
|
|
mcp: { bundle: docs/mcp, server: dagpipe, port: 8006 }
|
|
|
|
- name: mail-intake
|
|
source: ../mail-intake
|
|
title: Mail Intake
|
|
description: High-performance email ingestion and processing framework with pluggable adapters and automation workflows.
|
|
docs:
|
|
lib: site
|
|
mcp: { bundle: docs/mcp, server: mail_intake, port: 8002 }
|
|
|
|
- name: omniread
|
|
source: ../omniread
|
|
title: Omniread
|
|
description: Unified ingestion and normalization layer for structured and unstructured data sources.
|
|
docs:
|
|
lib: site
|
|
mcp: { bundle: docs/mcp, server: omniread, port: 8003 }
|
|
|
|
- name: py-jwt
|
|
source: ../py-jwt
|
|
title: Py JWT
|
|
description: Lightweight, explicit JWT utilities for Python services with strong validation and minimal magic.
|
|
docs:
|
|
lib: site
|
|
mcp: { bundle: docs/mcp, server: jwtlib, port: 8005 }
|
|
|
|
- name: hexa
|
|
source: ../hexa
|
|
title: Hexa
|
|
description: Hexagonal architecture framework and toolbox for Python services.
|
|
docs:
|
|
lib: site
|
|
|
|
- name: mongo-ops
|
|
source: ../mongo-ops
|
|
title: Mongo Ops
|
|
description: A modular, async MongoDB operations layer for FastAPI microservices. Simplifies CRUD, transactions, and model management.
|
|
docs:
|
|
wiki: site
|
|
|
|
- name: auth-server
|
|
source: ../auth-server
|
|
title: Auth Server
|
|
description: Aetoskia authentication service. OpenAPI-driven, FastAPI backend for auth flows.
|
|
docs:
|
|
api: site
|
|
|
|
static:
|
|
- kind: api
|
|
repo: blog
|
|
title: Blog API
|
|
description: A modular, async Blog API backend for FastAPI microservices. Provides streamlined CRUD operations for articles and authors.
|
|
path: blog
|
|
|
|
- kind: tutorial
|
|
repo: media-manager
|
|
title: Media Manager Tutorial
|
|
description: Step-by-step guide to the Media Manager architecture, ingestion pipeline, automation workflows, and integrations.
|
|
path: media-manager |