nextflow-io / nextflow

A DSL for data-driven computational pipelines
http://nextflow.io
Apache License 2.0
2.77k stars 630 forks source link

chore: Upgrade docs version. #5124

Closed gavinelder closed 4 months ago

gavinelder commented 4 months ago

Summary

The following upgrades our version of Python from 3.7 to 3.12 along with relevant dependency upgrades to support to version upgrade, the most notable of which is the major version upgrade of Sphinx from 5 -> 7

Testing

Testing was carried out as per the relevant documentation by building the docker container locally , generating the relevant documentation then serving the html locally, checking for build & output errors along with doing a visual comparison across all pages to ensure correct rendering.

image

Changes to Azure.md

The azure.md file contained invalid Pygments lexer's such as config & nextflow these have been updated to groovy to match existing doc-styles.

There was also some drive-by mark-down formatting.

Docker changes.

Requirements changes.

netlify[bot] commented 4 months ago

Deploy Preview for nextflow-docs-staging ready!

Name Link
Latest commit d9dcadcdb835972a7afc4bbef58a9d22c04ae338
Latest deploy log https://app.netlify.com/sites/nextflow-docs-staging/deploys/668cfeabfdc8550008e7dcf6
Deploy Preview https://deploy-preview-5124--nextflow-docs-staging.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

pditommaso commented 4 months ago

I had to revert this because it was insanely slow when running in my laptop 👉 770b3dde