Skip to content

feat: add ocis_helper - #117

Merged
mmattel merged 16 commits into
mainfrom
ocis_helper
Sep 10, 2026
Merged

feat: add ocis_helper#117
mmattel merged 16 commits into
mainfrom
ocis_helper

Conversation

@mmattel

@mmattel mmattel commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

The ocis helpers, an essential component to automate the generation of envvar docs, originally lived in the ocis repo, created many years ago, were never manintained and finally became inactive when changing to ocis 8.0

This PR:

  • Migrates the helpers by a decision with @kobergj and @mmattel to the docs side which eliminates a lot of task dependencies
  • Updates the helpers massively and bring them to a new level.
  • Migrate and integrate the delta file creation (added, deprecated and removed envvars) to go, originally a Python script.
  • Add new functionalities to helpers, especially with the -d flag which highlights for envvars inconsistent defaults or inconsistent descriptions.
  • Add a README
  • For all ocis releases:
    • Add required persistent files per version
    • Copied generated files per version for the Antora build process

Note that this PR DOES NOT add the required doc build changes to access the files generated. This will come in an additional PR.

When this PR is merged, we can cleanup the docs folder in the ocis repo.

@mmattel
mmattel requested a review from a team as a code owner September 10, 2026 07:04
@mmattel mmattel added the enhancement New feature or request label Sep 10, 2026
@mmattel
mmattel merged commit 827401b into main Sep 10, 2026
4 checks passed
@mmattel
mmattel deleted the ocis_helper branch September 10, 2026 07:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants