docs: separate public manual from internal project documentation
Publish documentation / publish (push) Successful in 27s
Publish documentation / publish (push) Successful in 27s
This commit is contained in:
Codex
+53
-87
@@ -1,5 +1,5 @@
|
||||
site_name: ThothII Docs
|
||||
site_description: Functional, technical, and operational documentation for ThothII
|
||||
site_description: Understand, install, and use ThothII
|
||||
site_url: https://git.tylconsulting.it/thothii-docs/
|
||||
docs_dir: docs
|
||||
site_dir: site
|
||||
@@ -42,92 +42,58 @@ markdown_extensions:
|
||||
format: !!python/name:mermaid2.fence_mermaid
|
||||
- pymdownx.tabbed:
|
||||
alternate_style: true
|
||||
# Public manual: deny by default, including search and copied assets.
|
||||
# Internal developer documents remain in Git, not in the generated site.
|
||||
# Keep these exceptions aligned with nav; scripts/verify-public-docs.py checks it.
|
||||
exclude_docs: |
|
||||
*
|
||||
!/index.md
|
||||
!/product-overview.md
|
||||
!/skills.md
|
||||
!/guida-utente.md
|
||||
!/install/first-start.md
|
||||
!/install/standalone-manual-it.md
|
||||
!/install/standalone-manual-en.md
|
||||
!/install/shell-and-language.md
|
||||
!/install/authentication-local.md
|
||||
!/install/authentication-oidc.md
|
||||
!/install/authentik.md
|
||||
!/general/pi-configuration.md
|
||||
!/operations/workspaces.md
|
||||
!/operations/database-management.md
|
||||
!/operations/sensitivity-analysis.md
|
||||
!/evidence.md
|
||||
!/usage/memory.md
|
||||
!/install/dwh-auth-server.md
|
||||
!/install/dwh-auth-client-enrollment.md
|
||||
!/install/dwh-auth-tls.md
|
||||
!/stylesheets/extra.css
|
||||
!/javascripts/layout-init.js
|
||||
!/install/examples/thothii-installation.local.yaml
|
||||
!/install/examples/thothii-installation.server.yaml
|
||||
!/install/examples/workspace-bindings.env.example
|
||||
nav:
|
||||
- Home: index.md
|
||||
- Install and operate:
|
||||
- Install and first start: install/first-start.md
|
||||
- Manual standalone installation (Italian): install/standalone-manual-it.md
|
||||
- Manual standalone installation (English): install/standalone-manual-en.md
|
||||
- Server upgrade from legacy release: operations/server-upgrade-gitea-workspace-v2.md
|
||||
- Preprocessing-complete server handoff: operations/server-handoff-260906-preprocessing-complete.md
|
||||
- Local authentication: install/authentication-local.md
|
||||
- Generic OIDC: install/authentication-oidc.md
|
||||
- Portal upstream authentication: install/authentication-upstream.md
|
||||
- Authentik: install/authentik.md
|
||||
- Workspace operations: operations/workspaces.md
|
||||
- Shell and localization: operations/shell-and-localization.md
|
||||
- Codex server handoff: operations/server-codex-handoff.md
|
||||
- Full shell verification: reports/2026-09-13-full-shell-implementation.md
|
||||
- Local sensitivity analysis: operations/sensitivity-analysis.md
|
||||
- Pi model configuration: general/pi-configuration.md
|
||||
- Docker installation contexts: installazione-docker-4-contesti.md
|
||||
- Use ThothII:
|
||||
- Understand ThothII:
|
||||
- Product overview: product-overview.md
|
||||
- Reviewed workflow: skills.md
|
||||
- User guide: guida-utente.md
|
||||
- Database management: operations/database-management.md
|
||||
- Evidence authoring and publication: evidence.md
|
||||
- Workflow references:
|
||||
- Initial disambiguation: disambiguazione-iniziale.md
|
||||
- Memory management: gestione-memory.md
|
||||
- Operating skills: skills.md
|
||||
- Architecture:
|
||||
- Overview: architecture/overview.md
|
||||
- Components, modules, and flows: architecture/components.md
|
||||
- Authentication and authorization: architecture/authentication.md
|
||||
- Full and embedded rendering: architecture/application-shell.md
|
||||
- Contracts and integration:
|
||||
- Portal Shell Adapter v1: contracts/portal-shell-adapter-v1.md
|
||||
- Catalog schema snapshot RPC: contracts/catalog-schema-snapshot.md
|
||||
- Workspace preprocessing CLI: contracts/workspace-preprocessing-cli.md
|
||||
- tht–DWH contract: contracts/tht-dwh.md
|
||||
- Workspace Evidence contract: contracts/workspace-evidence-v3.md
|
||||
- Editable Curated Evidence v4: contracts/curated-evidence-v4.md
|
||||
- Session archive corrections: contracts/archive-repair.md
|
||||
- DWH REST server: install/dwh-auth-server.md
|
||||
- DWH client enrollment: install/dwh-auth-client-enrollment.md
|
||||
- DWH REST TLS: install/dwh-auth-tls.md
|
||||
- Decisions and acceptance:
|
||||
- Shell and authentication acceptance: testing/authentication-manual-acceptance.md
|
||||
- Architecture decisions:
|
||||
- 0001 Metadata catalog: adr/0001-postgres-metadata-catalog.md
|
||||
- 0002 Workspace database secrets: adr/0002-workspace-database-secret-references.md
|
||||
- 0003 Installation-local bindings: adr/0003-installation-local-database-bindings.md
|
||||
- 0004 Fastify/Kysely catalog: adr/0004-fastify-kysely-metadata-catalog.md
|
||||
- 0005 Table deletion during synchronization: adr/0005-hard-delete-catalog-tables-during-synchronization.md
|
||||
- 0006 Physical and logical relationships: adr/0006-separate-physical-and-logical-relationships.md
|
||||
- 0007 Authoritative schema synchronization: adr/0007-durable-authoritative-schema-synchronization.md
|
||||
- 0008 Manual catalog cleanup: adr/0008-allow-manual-catalog-metadata-cleanup.md
|
||||
- 0009 Sequential description generation: adr/0009-use-one-sequential-description-generation-run.md
|
||||
- 0010 Bounded source samples: adr/0010-allow-bounded-real-source-samples-for-description-generation.md
|
||||
- 0011 Sensitive data flag: adr/0011-gate-source-samples-with-a-sensitive-data-flag.md
|
||||
- 0012 Effective relationship authority: adr/0012-use-the-catalog-as-the-logical-relationship-authority.md
|
||||
- 0013 Installation model catalog: adr/0013-use-one-installation-model-catalog-with-runtime-projections.md
|
||||
- 0014 Local sensitive-column assessment: adr/0014-assess-sensitive-columns-locally-from-source-content.md
|
||||
- 0015 Progressive sensitive-column sampling: adr/0015-use-progressive-sampling-for-sensitive-columns.md
|
||||
- 0016 PostgreSQL metadata for all core consumers: adr/0016-use-postgres-metadata-for-all-core-consumers.md
|
||||
- 0017 Separate reference vectors from runtime memory: adr/0017-separate-reference-vectors-from-runtime-memory.md
|
||||
- 0018 PostgreSQL Memory authority and Qdrant retrieval: adr/0018-use-postgres-for-memory-and-qdrant-for-retrieval.md
|
||||
- 0019 Evidence editing and manual consolidation: adr/0019-author-evidence-in-app-with-automatic-activation.md
|
||||
- 0021 Shell modes and replaceable portal adapter: adr/0021-separate-shell-modes-and-replaceable-portal-adapter.md
|
||||
- 0022 UI locale and session interaction language: adr/0022-separate-ui-locale-from-session-interaction-language.md
|
||||
- AI catalog description acceptance: testing/2026-08-29-ai-catalog-description-generation-acceptance.md
|
||||
- Sensitivity NER license inventory: reports/2026-09-02-sensitivity-ner-license-inventory.md
|
||||
- PSD sensitivity shadow evaluation: reports/2026-09-02-psd-sensitivity-shadow.md
|
||||
- PSD progressive sensitivity shadow evaluation: reports/2026-09-03-psd-progressive-sensitivity-shadow.md
|
||||
- Design records:
|
||||
- Security hardening PRD (draft): plans/2026-09-08-security-hardening-prd.md
|
||||
- Security hardening session prompt: plans/2026-09-08-security-hardening-resume-prompt.md
|
||||
- Memory and Evidence administration: plans/2026-09-08-memory-evidence-administration.md
|
||||
- Memory management project: plans/2026-09-08-memory-management.md
|
||||
- Memory M1 specification: plans/2026-09-08-memory-m1-spec.md
|
||||
- Memory M2 implementation and validation: plans/2026-09-09-memory-m2-validation.md
|
||||
- Evidence management project: plans/2026-09-08-evidence-management.md
|
||||
- Evidence E1 validation: plans/2026-09-09-evidence-e1-validation.md
|
||||
- Evidence E2 validation: plans/2026-09-09-evidence-e2-validation.md
|
||||
- Evidence E3 validation: plans/2026-09-09-evidence-e3-validation.md
|
||||
- Archive repair X1 validation: plans/2026-09-09-archive-repair-x1-validation.md
|
||||
- Memory and Evidence simplification review: plans/2026-09-08-memory-evidence-simplification-review.md
|
||||
- Metadata catalog design: plans/2026-08-26-metadata-catalog-from-thothai.md
|
||||
- Description generation design: plans/2026-08-28-ai-catalog-description-generation.md
|
||||
- Description generation specification: plans/2026-08-28-ai-catalog-description-generation-spec.md
|
||||
- Full shell and portal integration: plans/2026-09-13-full-shell-and-portal-integration.md
|
||||
- Full shell specification: plans/2026-09-13-full-shell-spec.md
|
||||
- Install:
|
||||
- Start here: install/first-start.md
|
||||
- Mac, Windows, Linux — Italiano: install/standalone-manual-it.md
|
||||
- Mac, Windows, Linux — English: install/standalone-manual-en.md
|
||||
- Display mode and language: install/shell-and-language.md
|
||||
- Local authentication: install/authentication-local.md
|
||||
- OIDC authentication: install/authentication-oidc.md
|
||||
- Authentik: install/authentik.md
|
||||
- Model configuration: general/pi-configuration.md
|
||||
- Administer:
|
||||
- Workspaces: operations/workspaces.md
|
||||
- Databases and descriptions: operations/database-management.md
|
||||
- Sensitive columns: operations/sensitivity-analysis.md
|
||||
- Evidence: evidence.md
|
||||
- Memory: usage/memory.md
|
||||
- Connect a REST DWH:
|
||||
- Server: install/dwh-auth-server.md
|
||||
- Client enrollment: install/dwh-auth-client-enrollment.md
|
||||
- TLS: install/dwh-auth-tls.md
|
||||
|
||||
Reference in New Issue
Block a user