Skip to content

Add automated documentation translation and publishing workflow - #3460

Open
Salvialf wants to merge 1 commit into
developfrom
feat/docs-workflow
Open

Add automated documentation translation and publishing workflow#3460
Salvialf wants to merge 1 commit into
developfrom
feat/docs-workflow

Conversation

@Salvialf

@Salvialf Salvialf commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Adds .github/workflows/docs.yml: on push to release touching docs/**, translates docs/fr_FR via jeedom/jeetranslate-docs when it changed, and publishes to jeedom/documentations via jeedom/workflows/docs-publish.yml once the translated locales (or images) actually land. A workflow_dispatch input allows backfilling an already-shipped version from an arbitrary ref.

Part of the documentation translation rework tracked in jeedom/documentations#166.

For context: #3252 explored a different direction for this same underlying problem (per-repo GitHub Pages hosting + browser-native translation). This PR is part of a different approach instead: keep jeedom/documentations centralized, with an automated DeepL-based translation pipeline replacing the broken one.

The publish job is intentionally commented out in this PR. jeedom/documentations still has its old, duplicated layout on master; publishing now would write into it incorrectly. It must stay disabled until jeedom/documentations#166's rework branch merges to master, and until the DOCS_REPO_TOKEN organization secret described there exists. The translate job is safe to enable right away, it never touches jeedom/documentations.

@Salvialf Salvialf added the changelog-docs Use to generate release notes / changelog To be apply on PR label Aug 7, 2026
@Salvialf
Salvialf requested review from Mips2648 and zoic21 August 7, 2026 13:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

changelog-docs Use to generate release notes / changelog To be apply on PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants