Thanks to visit codestin.com
Credit goes to github.com

Skip to content

I18N step delaying docbuild #7925

@akaszynski

Description

@akaszynski

Describe what maintenance you would like added.

The I18N step in our docbuild on often takes longer than two hours to complete when run on main:

- name: Build I18N Documentation
if: startsWith(github.ref, 'refs/heads/main') || startsWith(github.ref, 'refs/tags/v')
run: |
make -C doc \
gen-external-examples \
gen-dataset-gallery \
mini18n-html SPHINXOPTS="${{ env.SPHINX_JOBS }}"
find doc/_build/mini18n-html -mindepth 1 -maxdepth 1 -type d -exec cp -rf {} doc/_build/html/ \;
rm -rf doc/_build/mini18n-html

Image

This means it can take around 3 hours from merging a PR to being able to merge another unless we decide to ignore the doctest, in which case our CI on main has failed documentation runs due to concurrency.

As far as I know I18N doesn't support multi-process building nor respects the number of sphinx jobs and I'm unsure what workaround to propose except to disable unless on release or simply wait the three hours for the CI.

Links to source code.

No response

Pseudocode or Screenshots

Insert code here

Or drag your screenshot here!

Metadata

Metadata

Assignees

No one assigned

    Labels

    maintenanceLow-impact maintenance activity

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions