Repository navigation
Conversation
|
|
…ptions Audit of the oCIS 9.0.0-rc.1 documentation against the running oCIS 9.0.0-rc.1 binary, the oCIS source at tag v9.0.0-rc.1, and the owncloud/ocis-charts Helm chart. 201 files changed (+845/-212): - Phase 2 (37 files): correctness fixes - wrong env vars (metrics debug token, OCIS_LOG_LEVEL), wrong ports, stale accounts-service and GLAuth references, fully rewritten request-flow diagram, modernised debugging guide, corrected metrics guide, typo fixes, stable-8.2 -> stable-9.0 branch names, continuous deployment three flavors, ADR-0005 note. - Phase 3 (16 pages): reading time, level, lastUpdatedVersion/Date attributes, abstracts, and FAQ sections with AP title case headings. - Phase 4 (185 files): unique meta descriptions (<=155 chars) for all pages that lacked them; AP title case for new FAQ headings. - Phase 5 (2 files): architecture and registry Mermaid diagrams and deployment-model pro/cons tables. Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai> Signed-off-by: David Walter <david.walter@kiteworks.com>
dj4oC
force-pushed
the
audit/ocis-9.0-docs-audit
branch
from
October 26, 2026 08:22
e2a4e06 to
789740b
Compare
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Audit of the oCIS 9.0.0-rc.1 documentation (
content/ocis/9.0) against ground truth: the runningocis-9.0.0-rc.1binary, the oCIS source at tagv9.0.0-rc.1, and theowncloud/ocis-chartsHelm chart.201 files changed, +845/−212.
Phase 2 — Correctness fixes (37 files)
<SERVICE>_DEBUG_TOKENper service (no globalOCIS_DEBUG_TOKEN/--debug-tokenflag in 9.0);OCIS_LOG_LEVELinstead of--log-levelflow-docs/request-flow.adocfully rewritten and verified against the 9.0 request flowdevelopment/debugging.adocmodernised (current service names,reva/v2,nats,ocis-debug frontend)stable-8.2→stable-9.0branch names; continuous deployment now documents three flavorsPhase 3 — Page enrichment (16 pages)
Service and deployment pages (
settings,auth-basic,auth-bearer,auth-app,nats,idm,eventhistory,webui-customisation,tls) gained:readingTime:,:level:,:lastUpdatedVersion: 9.0.0-rc.1,:lastUpdatedDate: 2026-10-25, an abstract with a reading-time line, and an== FAQsection.Phase 4 — Unique meta descriptions (185 files)
All pages that lacked
:description:(172 developer + 13 admin command pages) now have unique descriptions of ≤155 characters. The 51 new FAQ headings use AP title case percontent/AGENTS.md.Phase 5 — Diagrams and tables (2 files)
Architecture and service-registry Mermaid diagrams updated to the 9.0 service layout; deployment-model pro/cons tables.
Verification
content/ocis/9.0have:description:; 296 unique values; 0 duplicates involving newly added descriptionsnpx antora --stacktrace site.yml: 0 errors; the only 2 asciidoctor warnings are pre-existing (auth-app.adoc, lines unchanged by this PR)v9.0.0-rc.1Open questions for maintainers
display_version: '9.0 (dev)'in the example config — confirm against the released binaryappVersionstill 8.2.0 for the 9.0 line (chart repo update needed)Full audit report: 40 findings (0 blockers, 16 major, 19 minor, 6 info).