Skip to content

refactor: remove sphinxdocs dependency - #812

Merged
AlexanderLanin merged 3 commits into
eclipse-score:mainfrom
etas-contrib:backup/full-sphinx-replacement
Sep 9, 2026
Merged

refactor: remove sphinxdocs dependency#812
AlexanderLanin merged 3 commits into
eclipse-score:mainfrom
etas-contrib:backup/full-sphinx-replacement

Conversation

@AlexanderLanin

Copy link
Copy Markdown
Member

Why

The documentation build still depends on the external sphinxdocs Bazel module for Needs generation, even though the surrounding bundle and CLI behavior is maintained in this repository. Removing that split ownership simplifies the build and keeps the Needs action aligned with the repository-owned bundle provider.

What changed

  • Replace the external SphinxDocs Bazel rule with a repository-owned Needs JSON action.
  • Remove the sphinxdocs module and lockfile dependency plus obsolete adapter code.
  • Extend the docs CLI to support the Bazel Needs action while preserving normal CLI behavior.
  • Retain direct bundle-source projection and add focused regression coverage.

@github-actions

github-actions Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Documentation preview for this pull request is available at:
pr-812: https://eclipse-score.github.io/docs-as-code/pr-812/

@AlexanderLanin
AlexanderLanin force-pushed the backup/full-sphinx-replacement branch from 792b8fa to ceabea7 Compare September 9, 2026 13:36

@MaximilianSoerenPollak MaximilianSoerenPollak 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.

Sone questions for sure, but the premise looks nice.

Comment thread src/docs_cli/cli.py
Comment thread src/docs_cli/cli.py
Comment thread docs.bzl
Comment thread docs.bzl

This comment was marked as resolved.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟢 Approval recommended

The new action preserves declared inputs, output structure, configuration, and existing interactive CLI behavior without identified unresolved issues.

Review details
  • Files reviewed: 6/7 changed files
  • Comments generated: 0 new
  • Review effort level: Balanced

@MaximilianSoerenPollak MaximilianSoerenPollak 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.

Talked about in a call.

Good next step for refactoring

@AlexanderLanin
AlexanderLanin merged commit 40d5440 into eclipse-score:main Sep 9, 2026
20 checks passed
@AlexanderLanin
AlexanderLanin deleted the backup/full-sphinx-replacement branch September 9, 2026 18:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

3 participants