Skip to content

Conversation

rffontenelle
Copy link
Collaborator

Makefile:

  • Add pomerge to merge translations from 3.8 to older branches
  • Reorganize and add documentation to variables
  • Remove echo of command lines for a cleaner output
  • Fix bug in tx-config of incorrect use of OLDPWD variable
  • clone CPython using --no-single-branch to allow checkout of other branches

Workflow:

  • use default python version (3.8) by removing python-version from strategy,matrix
  • update actions/setup-python and actions/upload-artifact actions to version 2
  • split all-in-one build job into main update (most actions) and secondary_merge, spellcheck and build-warn-as-err to reduce the size of the output log and to make it easier to read it
  • rename workflow to python-docs-pt-br CI

Use JulienPalard and seluj78's pomerge tool to merge translations
from current branch with older branches, making it possible to
keep documentations of older versions of Python up-to-date with
latest translations.

workflow: add pomerge step

Makefile: add 'merge' target

requirements: add pomerge to be installed by pip
Instead of changing dir to OLDPWD in an incorrect way,
now using mkdir and sed to create .tx/config
Add @ to the beginning of the command lines to avoid echoing them,
and add messages of what is being executed.
Reorganize variables, adding documentation to them
Doing shallow clone (--depth 1) didn't make possible to checkout
other branches of CPython, which could be useful for using this
script in other branches at some point, e.g. building Python docs.
Now going to use latest python version (3.8)
- Rename workflow name to 'python-docs-pt-br CI', as it makes
  more sense than the generic 'Build and update documentation'

- Separate jobs: rename main workflow from build to 'update';
  and move 'merge', 'spell' and 'build' (warnings as errors)
  into separate jobs, called right next 'update' is done

- Simplify 'run' calls, reducing 'name' and '--version' print
  (log file already has the version installed)

- Remove pip-install-log artifact uploading, as the script
  does not generate this log anymore.

- The 'build-warn-as-err' job create an artifact containing
  log files if job has failed
@rffontenelle
Copy link
Collaborator Author

See how the workflow would be logged: https://github.com/rffontenelle/python-docs-pt-br/actions/runs/101515431

@rougeth
Copy link
Collaborator

rougeth commented May 11, 2020

I liked the previous name for the workflow. This is an example of a badge we can add to the README.md page:

python-docs-pt-br CI

I think a name a bit more explicit would be better, your call though :)

@rffontenelle
Copy link
Collaborator Author

No problem, I can change back to Build and update documentation. Sadly, it isn't possible to have a badge per job.

@rougeth rougeth merged commit 02b7338 into python:3.8 May 11, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants