Skip to content

feat: Migration of the developer docs to Antora - #155

Merged
LukasHirt merged 29 commits into
mainfrom
migration_of_the_developer_docs
Oct 15, 2026
Merged

LukasHirt merged 29 commits into
mainfrom
migration_of_the_developer_docs

Conversation

@mmattel

@mmattel mmattel commented Oct 15, 2026

Copy link
Copy Markdown
Contributor

This is the migration of the developer documentation from the ocis repo into this documentation repo. Everything is now fully integrated in the Antora framework.

Without going into the details, the migration was a massive change, but now everything is consistent, clear in the setup and commented where required. The Claude/AGENTS files have been updated so others benefit from the work done.

Post merging, we can:

  • Retire the owncloud.dev homepage and do a full redirect to doc.owncloud.com
  • The docs/ content in the ocis repo is now obsolete, but this needs checking before removal
  • If possible, we can retire the owncloud.github.io repo as this is imho no longer used - to be checked.
    This was the repo holding the hugo framework that was required building owncloud.dev

IMPORTANT: there is no forwarding of content from the old web page possible, this is a breaking change !!

Note that this PR also fully integrates the Swagger-UI (LibgeGraph) and the ocis-php-sdk documentation. 😄

Tasks post merging:

  • ocis developers MUST cross read, pls also double check the releasing guide if the steps match the required procedures (this starts in the root of the documentation
  • web developers MUST cross read the web documentation which can be found in the client section (starts in the root)

@mmattel
mmattel requested a review from a team as a code owner October 15, 2026 14:38
@mmattel mmattel added the documentation Improvements or additions to documentation label Oct 15, 2026
@mmattel mmattel changed the title Migration of the developer docs to Antora feat: Migration of the developer docs to Antora Oct 15, 2026

@LukasHirt LukasHirt left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Marking this like this just to prevent merge before the llm js changes are moved to a separate PR since this PR is focused on dev docs - not on internal tooling. Already working on the split now.

Comment thread AGENTS.md Outdated
@LukasHirt

Copy link
Copy Markdown
Contributor

PR with the llms.txt changes: #156

@mmattel
mmattel force-pushed the migration_of_the_developer_docs branch from 74ed0bf to f994869 Compare October 15, 2026 18:31
Move content-authoring rules to content/AGENTS.md, oCIS-specific rules
to content/ocis/AGENTS.md and UI JavaScript rules to ui/AGENTS.md, and
add CLAUDE.md symlinks beside each. The files live above the version
directories so they survive versions being added or dropped.

Add a build-output test ensuring AGENTS.md/CLAUDE.md are never published.

Signed-off-by: Lukas Hirt <info@hirt.cz>
@LukasHirt
LukasHirt merged commit 68a0ee0 into main Oct 15, 2026
5 checks passed
@LukasHirt
LukasHirt deleted the migration_of_the_developer_docs branch October 15, 2026 19:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants