Multi-language AI translation support by ewels · Pull Request #793 · nextflow-io/training

ewels · 2026-01-30T17:48:26Z

Summary

Adds infrastructure to support AI-generated translations of Nextflow training materials.

How It Works

Content is written in English (docs/en/docs/)
Translations are generated by AI using language-specific prompts (docs/<lang>/llm-prompt.md)
Automatic updates - when English content changes, GitHub Actions detects outdated translations and creates PRs
Human review - reviewers check translations and improve prompts (not the translated files directly)

Supported Languages

en (source), de, es, fr, hi, it, ko, pl, pt, tr

Documentation

See TRANSLATING.md for full details on:

Reviewing translation PRs
Fixing translation errors (by updating prompts)
Adding missing courses
Adding new languages

Reorganize docs from suffix-based (.pt.md) to folder-based structure: - docs/en/ contains all English source content - docs/{lang}/ contains translations with inheritance from English - Language configs use INHERIT: ../en/mkdocs.yml for DRY setup Add translation tooling: - _scripts/translate.py: Claude-powered translation CLI - _scripts/docs.py: Parallel multi-language build CLI - _scripts/translation_fixer.py: Post-translation cleanup - _scripts/mkdocs_hooks.py: Warning banner for untranslated content Add CI workflows: - translate.yml: Manual workflow to trigger translations - Updated docs-dev.yml and docs-release.yml for multi-language builds Add language picker JavaScript for mike versioning compatibility. Add TRANSLATING.md contributor guide.

… comments - Update MODEL to use 'claude-sonnet-4-5' alias for auto-updates - Add check_api_key() with helpful error message and setup instructions - Add multi-line /* */ comment support for Groovy/Nextflow/Java - Replace hardcoded SUPPORTED_LANGS with get_supported_langs() reading from language_names.yml as single source of truth

Update references to mkdocs.yml and docs/ paths in: - CONTRIBUTING.md - CLAUDE.md - preview_release.py - .claude/ skills and commands

- Remove requirements.txt and _scripts/pyproject.toml - Add MkDocs dependencies to docs.py inline script - Update netlify.toml to use uv run - Update CONTRIBUTING.md with uv instructions

- Fix Netlify uv PATH (use export instead of source env) - Update mkdocs.Dockerfile to install plugins directly (no requirements.txt) - Remove requirements.txt trigger from docker-mkdocs workflow - Add -w /docs/docs/en to all Docker commands in docs - Update preview commands to use uv

- Remove pillow, cairosvg, mkdocs-static-i18n from docs.py (not used) - Remove CARDS=false references from docs (social cards plugin not configured) - Fix image paths in LICENSE.md and README.md for new docs structure - Add better error capture for parallel builds - Update pip install instruction to use uv in CONTRIBUTING.md

- Add resolve_en_path() to handle paths relative to CWD, repo root, or EN_DOCS_PATH - Add --include/-i option to add_missing for filtering by pattern (e.g., 'hello_nextflow')

…ules - Add note that terms like channel/process/workflow may be translated in prose - Clarify that language-specific llm-prompt.md takes precedence for prose - Code blocks always use English for executable code

netlify · 2026-01-30T17:48:33Z

✅ Deploy Preview for nextflow-training ready!

Name	Link
🔨 Latest commit	`1cf5718`
🔍 Latest deploy log	https://app.netlify.com/projects/nextflow-training/deploys/69813006deb95a00088ae585
😎 Deploy Preview	https://deploy-preview-793--nextflow-training.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

github-actions · 2026-01-30T17:49:14Z

Nextflow linting complete!

❌ 1 files had 1 errors
✅ 169 files had no errors
🔧 125 files would be changed by auto-formatting

^{💡 Tip: Click filename locations to go directly to that code.}

View all 1 issues

Type	Location	Message
Error	hello-nf-core/solutions/core-hello-part2/nextflow.config:154:17	Invalid include source: '/home/runner/work/training/training/hello-nf-core/solutions/core-hello-part2/conf/test_full.config'

View formatting changes

File	Diff
hello-nextflow/solutions/1-hello-world/hello-world-2.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file */ process sayHello { - output: path 'output.txt'
hello-nextflow/solutions/1-hello-world/hello-world-3.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file */ process sayHello { - input: val greeting
hello-nextflow/solutions/2-hello-channels/hello-channels-1.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file */ process sayHello { - input: val greeting @@ -29,7 +28,7 @@ workflow { main: // create a channel for inputs greeting_ch = channel.of('Hello Channels!') - .view() + .view() // emit a greeting ... (truncated)
hello-nextflow/solutions/2-hello-channels/hello-channels-2.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file */ process sayHello { - input: val greeting @@ -29,7 +28,7 @@ workflow { main: // create a channel for inputs greeting_ch = channel.of('Hello', 'Bonjour', 'Holà') - .view() + .view() // emit a greeting ... (truncated)
hello-nextflow/solutions/2-hello-channels/hello-channels-3.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file */ process sayHello { - input: val greeting @@ -28,12 +27,12 @@ workflow { main: // declare an array of input greetings - greetings_array = ['Hello','Bonjour','Holà'] + greetings_array = ['Hello', 'Bonjour', 'Holà'] // create a channel for inputs ... (truncated)
hello-nextflow/solutions/2-hello-channels/hello-channels-4.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file */ process sayHello { - input: val greeting @@ -29,11 +28,11 @@ workflow { main: // create a channel for inputs from a CSV file greeting_ch = channel.fromPath(params.input) - .view { csv -> "Before splitCsv: $csv" } - .splitCsv() - .view { csv -> "After splitCsv: $csv" } ... (truncated)
hello-nextflow/solutions/3-hello-workflow/hello-workflow-1.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file / process sayHello { - input: val greeting @@ -21,7 +20,6 @@ process sayHello { Use a text replacement tool to convert the greeting to uppercase */ process convertToUpper { - input: path input_file ... (truncated)
hello-nextflow/solutions/3-hello-workflow/hello-workflow-2.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file / process sayHello { - input: val greeting @@ -21,7 +20,6 @@ process sayHello { Use a text replacement tool to convert the greeting to uppercase */ process convertToUpper { - input: path input_file ... (truncated)
hello-nextflow/solutions/3-hello-workflow/hello-workflow-3.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file / process sayHello { - input: val greeting @@ -21,7 +20,6 @@ process sayHello { Use a text replacement tool to convert the greeting to uppercase */ process convertToUpper { - input: path input_file ... (truncated)
hello-nextflow/solutions/3-hello-workflow/hello-workflow-4.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file / process sayHello { - input: val greeting @@ -21,7 +20,6 @@ process sayHello { Use a text replacement tool to convert the greeting to uppercase */ process convertToUpper { - input: path input_file ... (truncated)
hello-nextflow/solutions/4-hello-modules/hello-modules-2.nf	View @@ -7,7 +7,6 @@ include { sayHello } from './modules/sayHello.nf' * Use a text replacement tool to convert the greeting to uppercase / process convertToUpper { - input: path input_file @@ -24,7 +23,6 @@ process convertToUpper { Collect uppercase greetings into a single output file */ process collectGreetings { - input: path input_files ... (truncated)
hello-nextflow/solutions/4-hello-modules/hello-modules-3.nf	View @@ -8,7 +8,6 @@ include { convertToUpper } from './modules/convertToUpper.nf' * Collect uppercase greetings into a single output file */ process collectGreetings { - input: path input_files val batch_name @@ -38,8 +37,8 @@ workflow { main: // create a channel for inputs from a CSV file greeting_ch = channel.fromPath(params.input) - .splitCsv() - .map { line -> line[0] } + .splitCsv() ... (truncated)
hello-nextflow/solutions/4-hello-modules/hello-modules-4.nf	View @@ -18,8 +18,8 @@ workflow { main: // create a channel for inputs from a CSV file greeting_ch = channel.fromPath(params.input) - .splitCsv() - .map { line -> line[0] } + .splitCsv() + .map { line -> line[0] } // emit a greeting sayHello(greeting_ch) // convert the greeting to uppercase
hello-nextflow/solutions/4-hello-modules/modules/collectGreetings.nf	View @@ -4,7 +4,6 @@ * Collect uppercase greetings into a single output file */ process collectGreetings { - input: path input_files val batch_name
hello-nextflow/solutions/4-hello-modules/modules/convertToUpper.nf	View @@ -4,7 +4,6 @@ * Use a text replacement tool to convert the greeting to uppercase */ process convertToUpper { - input: path input_file
hello-nextflow/solutions/4-hello-modules/modules/sayHello.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file */ process sayHello { - input: val greeting
hello-nextflow/solutions/5-hello-containers/hello-containers-2.nf	View @@ -20,8 +20,8 @@ workflow { main: // create a channel for inputs from a CSV file greeting_ch = channel.fromPath(params.input) - .splitCsv() - .map { line -> line[0] } + .splitCsv() + .map { line -> line[0] } // emit a greeting sayHello(greeting_ch) // convert the greeting to uppercase
hello-nextflow/solutions/5-hello-containers/modules/collectGreetings.nf	View @@ -2,7 +2,6 @@ * Collect uppercase greetings into a single output file */ process collectGreetings { - input: path input_files val batch_name
hello-nextflow/solutions/5-hello-containers/modules/convertToUpper.nf	View @@ -4,7 +4,6 @@ * Use a text replacement tool to convert the greeting to uppercase */ process convertToUpper { - input: path input_file
hello-nextflow/solutions/5-hello-containers/modules/sayHello.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file */ process sayHello { - input: val greeting
hello-nextflow/solutions/6-hello-config/hello-config.nf	View @@ -20,8 +20,8 @@ workflow { main: // create a channel for inputs from a CSV file greeting_ch = channel.fromPath(params.input) - .splitCsv() - .map { line -> line[0] } + .splitCsv() + .map { line -> line[0] } // emit a greeting sayHello(greeting_ch) // convert the greeting to uppercase
hello-nextflow/solutions/6-hello-config/modules/collectGreetings.nf	View @@ -2,7 +2,6 @@ * Collect uppercase greetings into a single output file */ process collectGreetings { - input: path input_files val batch_name
hello-nextflow/solutions/6-hello-config/modules/convertToUpper.nf	View @@ -4,7 +4,6 @@ * Use a text replacement tool to convert the greeting to uppercase */ process convertToUpper { - input: path input_file
hello-nextflow/solutions/6-hello-config/modules/sayHello.nf	View @@ -4,7 +4,6 @@ * Use echo to print 'Hello World!' to a file */ process sayHello { - input: val greeting
hello-nextflow/solutions/6-hello-config/nextflow.config	View @@ -6,7 +6,7 @@ conda.enabled = true */ process { memory = 1.GB - withName: 'cowpy' { + withName: cowpy { memory = 2.GB cpus = 2 } @@ -35,7 +35,7 @@ profiles { process.resourceLimits = [ memory: 750.GB, cpus: 200, - time: 30.d + time: 30.d, ... (truncated)
hello-nf-core/solutions/composable-hello/hello.nf	View @@ -14,9 +14,7 @@ include { collectGreetings } from './modules/collectGreetings.nf' include { cowpy } from './modules/cowpy.nf' workflow HELLO { - take: - // channel of greetings greeting_ch main:
hello-nf-core/solutions/composable-hello/main.nf	View @@ -9,12 +9,12 @@ params.greeting = 'greetings.csv' workflow { // create a channel for inputs from a CSV file greeting_ch = channel.fromPath(params.greeting) - .splitCsv() - .map { line -> line[0] } + .splitCsv() + .map { line -> line[0] } // call the imported workflow on the channel of greetings HELLO(greeting_ch) // view the outputs emitted by the workflow - HELLO.out.view { output -> "Output: $output" } + HELLO.out.view { output -> "Output: ${output}" } ... (truncated)
hello-nf-core/solutions/composable-hello/modules/collectGreetings.nf	View @@ -10,8 +10,8 @@ process collectGreetings { val batch_name output: - path "COLLECTED-${batch_name}-output.txt" , emit: outfile - val count_greetings , emit: count + path "COLLECTED-${batch_name}-output.txt", emit: outfile + val count_greetings, emit: count script: count_greetings = input_files.size()
hello-nf-core/solutions/composable-hello/modules/convertToUpper.nf	View @@ -15,6 +15,6 @@ process convertToUpper { script: """ - cat '$input_file' \| tr '[a-z]' '[A-Z]' > 'UPPER-${input_file}' + cat '${input_file}' \| tr '[a-z]' '[A-Z]' > 'UPPER-${input_file}' """ }
hello-nf-core/solutions/composable-hello/modules/cowpy.nf	View @@ -17,6 +17,6 @@ process cowpy { script: """ - cat $input_file \| cowpy -c "$character" > cowpy-${input_file} + cat ${input_file} \| cowpy -c "${character}" > cowpy-${input_file} """ }
hello-nf-core/solutions/composable-hello/modules/sayHello.nf	View @@ -15,6 +15,6 @@ process sayHello { script: """ - echo '$greeting' > '$greeting-output.txt' + echo '${greeting}' > '${greeting}-output.txt' """ }
hello-nf-core/solutions/core-hello-part2/conf/base.config	View @@ -11,13 +11,13 @@ process { // TODO nf-core: Check the defaults for all processes - cpus = { 1 * task.attempt } - memory = { 6.GB * task.attempt } - time = { 4.h * task.attempt } + cpus = { 1 * task.attempt } + memory = { 6.GB * task.attempt } + time = { 4.h * task.attempt } errorStrategy = { task.exitStatus in ((130..145) + 104 + 175) ? 'retry' : 'finish' } - maxRetries = 1 - maxErrors = '-1' + maxRetries = 1 ... (truncated)
hello-nf-core/solutions/core-hello-part2/conf/modules.config	View @@ -15,7 +15,6 @@ process { publishDir = [ path: { "${params.outdir}/${task.process.tokenize(':')[-1].tokenize('_')[0].toLowerCase()}" }, mode: params.publish_dir_mode, - saveAs: { filename -> filename.equals('versions.yml') ? null : filename } + saveAs: { filename -> filename.equals('versions.yml') ? null : filename }, ] - }
hello-nf-core/solutions/core-hello-part2/conf/test.config	View @@ -14,18 +14,18 @@ process { resourceLimits = [ cpus: 2, memory: '4.GB', - time: '1.h' + time: '1.h', ] } params { - config_profile_name = 'Test profile' + config_profile_name = 'Test profile' config_profile_description = 'Minimal test dataset to check pipeline function' // Input data ... (truncated)
hello-nf-core/solutions/core-hello-part2/main.nf	View @@ -13,9 +13,9 @@ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ / -include { HELLO } from './workflows/hello' +include { HELLO } from './workflows/hello' include { PIPELINE_INITIALISATION } from './subworkflows/local/utils_nfcore_hello_pipeline' -include { PIPELINE_COMPLETION } from './subworkflows/local/utils_nfcore_hello_pipeline' +include { PIPELINE_COMPLETION } from './subworkflows/local/utils_nfcore_hello_pipeline' / ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ NAMED WORKFLOWS FOR PIPELINE @@ -26,7 +26,6 @@ include { PIPELINE_COMPLETION } from './subworkflows/local/utils_nfcore_hell // WORKFLOW: Run main analysis pipeline depending on type of input // ... (truncated)
hello-nf-core/solutions/core-hello-part2/modules/local/collectGreetings.nf	View @@ -10,8 +10,8 @@ process collectGreetings { val batch_name output: - path "COLLECTED-${batch_name}-output.txt" , emit: outfile - val count_greetings , emit: count + path "COLLECTED-${batch_name}-output.txt", emit: outfile + val count_greetings, emit: count script: count_greetings = input_files.size()
hello-nf-core/solutions/core-hello-part2/modules/local/convertToUpper.nf	View @@ -15,6 +15,6 @@ process convertToUpper { script: """ - cat '$input_file' \| tr '[a-z]' '[A-Z]' > 'UPPER-${input_file}' + cat '${input_file}' \| tr '[a-z]' '[A-Z]' > 'UPPER-${input_file}' """ }
hello-nf-core/solutions/core-hello-part2/modules/local/cowpy.nf	View @@ -17,6 +17,6 @@ process cowpy { script: """ - cat $input_file \| cowpy -c "$character" > cowpy-${input_file} + cat ${input_file} \| cowpy -c "${character}" > cowpy-${input_file} """ }
hello-nf-core/solutions/core-hello-part2/modules/local/sayHello.nf	View @@ -15,6 +15,6 @@ process sayHello { script: """ - echo '$greeting' > '$greeting-output.txt' + echo '${greeting}' > '${greeting}-output.txt' """ }
hello-nf-core/solutions/core-hello-part2/subworkflows/local/utils_nfcore_hello_pipeline/main.nf	View @@ -8,13 +8,13 @@ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */ -include { UTILS_NFSCHEMA_PLUGIN } from '../../nf-core/utils_nfschema_plugin' -include { paramsSummaryMap } from 'plugin/nf-schema' -include { samplesheetToList } from 'plugin/nf-schema' -include { paramsHelp } from 'plugin/nf-schema' -include { completionSummary } from '../../nf-core/utils_nfcore_pipeline' -include { UTILS_NFCORE_PIPELINE } from '../../nf-core/utils_nfcore_pipeline' -include { UTILS_NEXTFLOW_PIPELINE } from '../../nf-core/utils_nextflow_pipeline' +include { UTILS_NFSCHEMA_PLUGIN } from '../../nf-core/utils_nfschema_plugin' +include { paramsSummaryMap } from 'plugin/nf-schema' +include { samplesheetToList } from 'plugin/nf-schema' +include { paramsHelp } from 'plugin/nf-schema' ... (truncated)
hello-nf-core/solutions/core-hello-part2/subworkflows/nf-core/utils_nextflow_pipeline/main.nf	View @@ -10,9 +10,9 @@ workflow UTILS_NEXTFLOW_PIPELINE { take: - print_version // boolean: print version - dump_parameters // boolean: dump parameters - outdir // path: base directory used to publish pipeline results + print_version // boolean: print version + dump_parameters // boolean: dump parameters + outdir // path: base directory used to publish pipeline results check_conda_channels // boolean: check conda channels main: @@ -72,10 +72,10 @@ def getWorkflowVersion() { // ... (truncated)
hello-nf-core/solutions/core-hello-part2/subworkflows/nf-core/utils_nextflow_pipeline/tests/nextflow.config	View @@ -1,9 +1,9 @@ manifest { - name = 'nextflow_workflow' - author = """nf-core""" - homePage = 'https://127.0.0.1' - description = """Dummy pipeline""" + name = 'nextflow_workflow' + author = """nf-core""" + homePage = 'https://127.0.0.1' + description = """Dummy pipeline""" nextflowVersion = '!>=23.04.0' - version = '9.9.9' - doi = 'https://doi.org/10.5281/zenodo.5070524' + version = '9.9.9' + doi = 'https://doi.org/10.5281/zenodo.5070524' ... (truncated)
hello-nf-core/solutions/core-hello-part2/subworkflows/nf-core/utils_nfcore_pipeline/main.nf	View @@ -125,12 +125,12 @@ def paramsSummaryMultiqc(summary_params) { } def yaml_file_text = "id: '${workflow.manifest.name.replace('/', '-')}-summary'\n" as String - yaml_file_text += "description: ' - this information is collected when the pipeline is started.'\n" - yaml_file_text += "section_name: '${workflow.manifest.name} Workflow Summary'\n" - yaml_file_text += "section_href: 'https://github.com/${workflow.manifest.name}'\n" - yaml_file_text += "plot_type: 'html'\n" - yaml_file_text += "data: \|\n" - yaml_file_text += "${summary_section}" + yaml_file_text += "description: ' - this information is collected when the pipeline is started.'\n" + yaml_file_text += "section_name: '${workflow.manifest.name} Workflow Summary'\n" + yaml_file_text += "section_href: 'https://github.com/${workflow.manifest.name}'\n" + yaml_file_text += "plot_type: 'html'\n" + yaml_file_text += "data: \|\n" ... (truncated)
hello-nf-core/solutions/core-hello-part2/subworkflows/nf-core/utils_nfcore_pipeline/tests/nextflow.config	View @@ -1,9 +1,9 @@ manifest { - name = 'nextflow_workflow' - author = """nf-core""" - homePage = 'https://127.0.0.1' - description = """Dummy pipeline""" - nextflowVersion = '!>=23.04.0' - version = '9.9.9' - doi = 'https://doi.org/10.5281/zenodo.5070524' + name = 'nextflow_workflow' + author = """nf-core""" + homePage = 'https://127.0.0.1' + description = """Dummy pipeline""" + nextflowVersion = '!>=23.04.0' + version = '9.9.9' ... (truncated)
hello-nf-core/solutions/core-hello-part2/subworkflows/nf-core/utils_nfschema_plugin/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part2/workflows/hello.nf	(truncated)
hello-nf-core/solutions/core-hello-part3/conf/base.config	(truncated)
hello-nf-core/solutions/core-hello-part3/conf/modules.config	(truncated)
hello-nf-core/solutions/core-hello-part3/conf/test.config	(truncated)
hello-nf-core/solutions/core-hello-part3/conf/test_full.config	(truncated)
hello-nf-core/solutions/core-hello-part3/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part3/modules/local/convertToUpper.nf	(truncated)
hello-nf-core/solutions/core-hello-part3/modules/local/cowpy.nf	(truncated)
hello-nf-core/solutions/core-hello-part3/modules/local/sayHello.nf	(truncated)
hello-nf-core/solutions/core-hello-part3/modules/nf-core/cat/cat/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part3/modules/nf-core/cat/cat/tests/nextflow_unzipped_zipped.config	(truncated)
hello-nf-core/solutions/core-hello-part3/modules/nf-core/cat/cat/tests/nextflow_zipped_unzipped.config	(truncated)
hello-nf-core/solutions/core-hello-part3/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-part3/subworkflows/local/utils_nfcore_hello_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part3/subworkflows/nf-core/utils_nextflow_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part3/subworkflows/nf-core/utils_nextflow_pipeline/tests/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-part3/subworkflows/nf-core/utils_nfcore_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part3/subworkflows/nf-core/utils_nfcore_pipeline/tests/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-part3/subworkflows/nf-core/utils_nfschema_plugin/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part3/workflows/hello.nf	(truncated)
hello-nf-core/solutions/core-hello-part4/conf/base.config	(truncated)
hello-nf-core/solutions/core-hello-part4/conf/modules.config	(truncated)
hello-nf-core/solutions/core-hello-part4/conf/test.config	(truncated)
hello-nf-core/solutions/core-hello-part4/conf/test_full.config	(truncated)
hello-nf-core/solutions/core-hello-part4/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part4/modules/local/convertToUpper.nf	(truncated)
hello-nf-core/solutions/core-hello-part4/modules/local/cowpy.nf	(truncated)
hello-nf-core/solutions/core-hello-part4/modules/local/cowpy/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part4/modules/local/sayHello.nf	(truncated)
hello-nf-core/solutions/core-hello-part4/modules/nf-core/cat/cat/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part4/modules/nf-core/cat/cat/tests/nextflow_unzipped_zipped.config	(truncated)
hello-nf-core/solutions/core-hello-part4/modules/nf-core/cat/cat/tests/nextflow_zipped_unzipped.config	(truncated)
hello-nf-core/solutions/core-hello-part4/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-part4/subworkflows/local/utils_nfcore_hello_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part4/subworkflows/nf-core/utils_nextflow_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part4/subworkflows/nf-core/utils_nextflow_pipeline/tests/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-part4/subworkflows/nf-core/utils_nfcore_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part4/subworkflows/nf-core/utils_nfcore_pipeline/tests/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-part4/subworkflows/nf-core/utils_nfschema_plugin/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part4/workflows/hello.nf	(truncated)
hello-nf-core/solutions/core-hello-part5/conf/base.config	(truncated)
hello-nf-core/solutions/core-hello-part5/conf/modules.config	(truncated)
hello-nf-core/solutions/core-hello-part5/conf/test.config	(truncated)
hello-nf-core/solutions/core-hello-part5/conf/test_full.config	(truncated)
hello-nf-core/solutions/core-hello-part5/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part5/modules/local/convertToUpper.nf	(truncated)
hello-nf-core/solutions/core-hello-part5/modules/local/cowpy.nf	(truncated)
hello-nf-core/solutions/core-hello-part5/modules/local/cowpy/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part5/modules/local/sayHello.nf	(truncated)
hello-nf-core/solutions/core-hello-part5/modules/nf-core/cat/cat/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part5/modules/nf-core/cat/cat/tests/nextflow_unzipped_zipped.config	(truncated)
hello-nf-core/solutions/core-hello-part5/modules/nf-core/cat/cat/tests/nextflow_zipped_unzipped.config	(truncated)
hello-nf-core/solutions/core-hello-part5/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-part5/subworkflows/local/utils_nfcore_hello_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part5/subworkflows/nf-core/utils_nextflow_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part5/subworkflows/nf-core/utils_nextflow_pipeline/tests/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-part5/subworkflows/nf-core/utils_nfcore_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part5/subworkflows/nf-core/utils_nfcore_pipeline/tests/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-part5/subworkflows/nf-core/utils_nfschema_plugin/main.nf	(truncated)
hello-nf-core/solutions/core-hello-part5/workflows/hello.nf	(truncated)
hello-nf-core/solutions/core-hello-start/conf/base.config	(truncated)
hello-nf-core/solutions/core-hello-start/conf/modules.config	(truncated)
hello-nf-core/solutions/core-hello-start/conf/test.config	(truncated)
hello-nf-core/solutions/core-hello-start/conf/test_full.config	(truncated)
hello-nf-core/solutions/core-hello-start/main.nf	(truncated)
hello-nf-core/solutions/core-hello-start/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-start/subworkflows/local/utils_nfcore_hello_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-start/subworkflows/nf-core/utils_nextflow_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-start/subworkflows/nf-core/utils_nextflow_pipeline/tests/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-start/subworkflows/nf-core/utils_nfcore_pipeline/main.nf	(truncated)
hello-nf-core/solutions/core-hello-start/subworkflows/nf-core/utils_nfcore_pipeline/tests/nextflow.config	(truncated)
hello-nf-core/solutions/core-hello-start/subworkflows/nf-core/utils_nfschema_plugin/main.nf	(truncated)
hello-nf-core/solutions/core-hello-start/workflows/hello.nf	(truncated)
nextflow-run/solutions/3-main.nf	(truncated)
nextflow-run/solutions/modules/collectGreetings.nf	(truncated)
nextflow-run/solutions/modules/convertToUpper.nf	(truncated)
nextflow-run/solutions/modules/sayHello.nf	(truncated)
nextflow-run/solutions/nextflow.config	(truncated)
side-quests/solutions/debugging/buggy_workflow.nf	(truncated)
side-quests/solutions/essential_scripting_patterns/main.nf	(truncated)

… files - Added Translation Context Rules section explaining code vs prose distinction - Code blocks: keep ALL Nextflow syntax in English (must be executable) - Prose text: follow language-specific glossary for translations - Added language-specific examples for each

TRANSLATING.md: - Added clear workflow diagrams for automatic updates - Documented how to review and approve translation PRs - Added guide for fixing existing translations - Added guide for adding missing courses - Added guide for adding new languages - Improved script reference documentation .github/workflows/translate-auto.yml: - New workflow that triggers on push to master when docs/en/docs/*.md changes - Detects which languages have outdated translations - Updates translations in parallel (max 2 to limit API load) - Creates PRs automatically for review

TRANSLATING.md: - Explicitly discourage manual translations (will be overwritten) - Add detailed review guidelines with Mermaid flow diagram - Clarify that prompt updates are the ONLY way to fix translations - Remove all manual translation instructions - Add clear workflow for reporting issues CONTRIBUTING.md: - Expand translation section with rationale for AI-only approach - Add instructions for readers finding errors - Add instructions for contributors improving prompts _scripts/general-llm-prompt.md: - Massively expand from ~80 to ~300 lines - Add detailed code block examples for Groovy, Bash, config files - Add console output rules (never translate) - Add comprehensive admonition documentation - Add heading anchor preservation rules - Add link translation rules with examples - Add tab block documentation - Add frontmatter rules - Add special elements (kbd, icons, placeholders, snippets) - Add formatting preservation guidelines - Add common mistakes to avoid section - Add quality checklist

- Use GitHub [!WARNING] and [!CAUTION] admonition syntax - Move CLI reference to bottom (requires API key most don't have) - Clarify that prompt updates trigger regeneration in same PR - Promote GitHub Actions workflow as primary method - Add [!NOTE] for CLI section explaining API key requirement - Update CONTRIBUTING.md to match (warning admonition, GH Actions first)

- Update language list to include pl, tr - Add note that translations are AI-generated - Add TRANSLATING.md to resources section

.claude/commands/new-lesson.md

edmundmiller · 2026-01-30T20:10:51Z

.github/workflows/translate-auto.yml

+        id: check
+        working-directory: _scripts
+        run: |
+          # Check each language for outdated translations


🥹 Beautiful

vdauwera

Based on the feedback so far I think this is good enough for an initial release since this already massively improves the situation compared to the current status quo. We'll fix any issues as they are reported.

itrujnara · 2026-02-02T19:46:46Z

Has the preview recently been recalculated? The Polish translation still has the same issues it had before I edited the prompt (and sounds generally awkward)

vdauwera · 2026-02-02T19:49:31Z

Has the preview recently been recalculated? The Polish translation still has the same issues it had before I edited the prompt (and sounds generally awkward)

I made some changes to the French translation (and that would have updated the preview) but it shouldn't have affected any other translations

itrujnara · 2026-02-02T19:52:12Z

Okay, how do I re-run the Polish version? I want to check if the prompt changes have any effect

vdauwera · 2026-02-02T19:57:16Z

Okay, how do I re-run the Polish version? I want to check if the prompt changes have any effect

I'm not sure tbh, I made the changes directly with Claude, which I now realize is not the recommended way to do it. Reading the https://github.com/nextflow-io/training/blob/lang/TRANSLATING.md instructions now...

itrujnara · 2026-02-02T20:01:17Z

The instruction says I should trigger the translation action, but apparently it's not available as it's added in this PR

vdauwera · 2026-02-02T20:03:23Z

The instruction says I should trigger the translation action, but apparently it's not available as it's added in this PR

Yeah that's what I'm trying to figure out too. Asking the team internally... stay tuned

ewels · 2026-02-02T20:54:33Z

For now, I've just been opening claude manually and saying "apply the prompt". We'll figure out the automation side of things once we're on master.

@itrujnara I manually applied your prompt changes in 83528f9 - what was wrong with that? Incomplete, or completely missed parts?

ewels · 2026-02-02T20:55:20Z

ohh wait hang on, maybe I didn't tell it to actually apply the changes. Will do so now.

ewels · 2026-02-02T21:29:34Z

No, wait - I did try to apply the prompt changes! They're here: 281f89c#diff-0ff56a98928a1db949c1d7847840d9c3265d7d3403f1e48456deac89cfa3d9a9

But apparently it did a fairly poor job of it, as I just ran it again and it made a tonne of changes. It's possible that some stuff happened out of order, or that I just wasn't insistent enough that it kept going until it was done.

- Switch to informal tone (Ty/Wy instead of Pan/Pani) - Capitalize second-person pronouns (Twój, Swój, Ciebie, Ci) - Use apostrophe declension for English terms (workflow'u, pipeline'u) - Translate core terms: channel→kanał, process→proces - Replace 'przepływ pracy' with 'workflow' throughout - Replace 'potok' with 'pipeline' throughout Updates translations to match guidelines from commit 83528f9.

ewels · 2026-02-02T21:31:24Z

@itrujnara - many more changes done in a719e6f - hopefully that looks better?

- Add 'fix-translations' CLI command that uses LLM to review and fix existing translations to comply with updated prompt guidelines - Support multi-pass verification loop (default 8 iterations) until no more changes are needed - Add --files option for targeted fixes on specific files - Add --verify flag to update-outdated and add-missing commands - Update translate-auto.yml to detect prompt file changes and automatically trigger fix-translations when prompts are updated - Integrate translation_fixer.py post-processing into fix command This ensures translations stay consistent when prompt guidelines change, without requiring full re-translation of all content.

- Add fix-translations CLI reference to TRANSLATING.md - Document --verify flag for update-outdated command - Update workflow diagram to show prompt change detection - Add note about automatic fix-translations in CONTRIBUTING.md

itrujnara

It's definitely going in the right direction, but it's still not ideal. I've left more suggestions, but I have only looked at a handful of files. I might have more ideas once I have the time to give the tutorials a proper look.

docs/pl/llm-prompt.md

Co-authored-by: Igor Trujnara <53370556+itrujnara@users.noreply.github.com>

- Fix terminology: równoleglić→paralelizować, domena→dziedzina, podróż→droga - Reduce word repetition within sentences and consecutive sentences - Split sentences with more than 3 verbs for clarity - Applied across all Polish training modules (51 files)

ewels · 2026-02-02T22:57:42Z

Thanks @itrujnara - prompt updates included, and rework of the translation accordingly in aaaf302

ewels · 2026-02-02T23:36:03Z

Thanks for the help all! This PR is a monster and I was worried about it lagging behind other changes, so we have merged. Keep the suggestions coming though! Either as issues, or better still as PRs to the language prompt files. Then we can test out the new automation 🙏🏻 😅

ewels added 13 commits January 30, 2026 14:02

Update prettierignore paths for new docs structure

b8307cf

Update Netlify config for new docs/en/ structure

aa83dfc

Update file paths for new docs/en/ structure

0db7bdd

Update references to mkdocs.yml and docs/ paths in: - CONTRIBUTING.md - CLAUDE.md - preview_release.py - .claude/ skills and commands

Add build outputs and venv to gitignore

4791ecc

Simplify dependency management: use uv with inline script deps

6aa999c

- Remove requirements.txt and _scripts/pyproject.toml - Add MkDocs dependencies to docs.py inline script - Update netlify.toml to use uv run - Update CONTRIBUTING.md with uv instructions

Add .gitkeep files to ensure translation docs directories exist

9f739ae

Bump mkdocs-quiz minimum version to 1.5.4 for language detection fix

e1536db

Fix translate.py: resolve paths flexibly and add --include filter

1f61835

- Add resolve_en_path() to handle paths relative to CWD, repo root, or EN_DOCS_PATH - Add --include/-i option to add_missing for filtering by pattern (e.g., 'hello_nextflow')

Update general-llm-prompt.md: clarify context-dependent translation r…

371a4b5

…ules - Add note that terms like channel/process/workflow may be translated in prose - Clarify that language-specific llm-prompt.md takes precedence for prose - Code blocks always use English for executable code

ewels mentioned this pull request Jan 30, 2026

Add Portuguese translation for Hello Nextflow course #794

Merged

ewels mentioned this pull request Jan 30, 2026

Add French translation for Hello Nextflow course #800

Merged

ewels added 8 commits January 30, 2026 20:20

Use Mermaid diagram for translation workflow flow

53f89b2

Add prettier-ignore to preserve GitHub admonition formatting

6a5f1d5

Render glossary example as table instead of code block

73b228e

Add TRANSLATING.md references to CLAUDE.md and .claude/README.md

1fce5be

- Update language list to include pl, tr - Add note that translations are AI-generated - Add TRANSLATING.md to resources section

Add translation reminder to new-lesson and new-module commands

21f3660

edmundmiller reviewed Jan 30, 2026

View reviewed changes

.claude/commands/new-lesson.md Show resolved Hide resolved

edmundmiller reviewed Jan 30, 2026

View reviewed changes

ewels added 2 commits January 30, 2026 23:31

Add German (de) language support

ef4ca5b

Add Hindi (hi) language support

25759b0

vdauwera mentioned this pull request Feb 2, 2026

Translations of index and other pages are WAY out of date #403

Closed

vdauwera self-requested a review February 2, 2026 19:42

vdauwera approved these changes Feb 2, 2026

View reviewed changes

Merge remote-tracking branch 'origin/master' into lang

2424f4a

vdauwera mentioned this pull request Feb 2, 2026

Merge in new translations #808

Closed

ewels added 3 commits February 2, 2026 22:41

Fix SVG snippet paths after directory restructure

bd9bbfe

itrujnara reviewed Feb 2, 2026

View reviewed changes

docs/pl/llm-prompt.md Show resolved Hide resolved

docs/pl/llm-prompt.md Outdated Show resolved Hide resolved

docs/pl/llm-prompt.md Outdated Show resolved Hide resolved

ewels and others added 3 commits February 2, 2026 22:58

Comment out video embeds in hello_nextflow module

76c864f

Apply suggestions from code review

d89da99

Co-authored-by: Igor Trujnara <53370556+itrujnara@users.noreply.github.com>

ewels added 3 commits February 3, 2026 00:02

Fix pre-commit

b2339d6

Also comment out the admonition about youtube videos

48aafba

Apply comment change to translations for orientation page

1cf5718

ewels merged commit 55b8c3a into master Feb 2, 2026
10 checks passed

ewels deleted the lang branch February 2, 2026 23:30

Conversation

ewels commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

How It Works

Supported Languages

Documentation

Uh oh!

netlify bot commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for nextflow-training ready!

Uh oh!

github-actions bot commented Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

edmundmiller Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

vdauwera left a comment

Choose a reason for hiding this comment

Uh oh!

itrujnara commented Feb 2, 2026

Uh oh!

vdauwera commented Feb 2, 2026

Uh oh!

itrujnara commented Feb 2, 2026

Uh oh!

vdauwera commented Feb 2, 2026

Uh oh!

itrujnara commented Feb 2, 2026

Uh oh!

vdauwera commented Feb 2, 2026

Uh oh!

ewels commented Feb 2, 2026

Uh oh!

ewels commented Feb 2, 2026

Uh oh!

ewels commented Feb 2, 2026

Uh oh!

ewels commented Feb 2, 2026

Uh oh!

itrujnara left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ewels commented Feb 2, 2026

Uh oh!

Uh oh!

ewels commented Feb 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

ewels commented Jan 30, 2026 •

edited

Loading

netlify bot commented Jan 30, 2026 •

edited

Loading

github-actions bot commented Jan 30, 2026 •

edited

Loading