Skip to content

Conversation

@oliver-sanders
Copy link
Member

@oliver-sanders oliver-sanders commented Nov 14, 2025

Have been meaning to get around to this for the last ~5 years 🤦!

Screenshot from 2025-11-14 11-14-44

Environment variables how have hyperlink anchors (so we can send references to them in support) and are crosslinked throughout the docs. We can also link them (via intersphinx) from other Sphinx projects (e.g, internal docs).

Requirements check-list

  • I have read CONTRIBUTING.md and added my name as a Code Contributor.

* Use the `envvar` directive to document environment variables,
  closes cylc#226
* Cross reference env vars throughout the docs,
  addresses cylc#124
* Copy the environment variable documentation from the Cylc wrapper
  script into the environment variable reference,
  addresses cylc#558
* Improve job env var documentation and cross link into the Cylc
  configuration reference where appropriate,
  addresses cylc#124
@oliver-sanders oliver-sanders added this to the 8.7.x milestone Nov 14, 2025
@oliver-sanders oliver-sanders requested a review from wxtim November 14, 2025 11:16
@oliver-sanders oliver-sanders self-assigned this Nov 14, 2025
Copy link
Member

@wxtim wxtim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good.

  • Tested at myserver/doc/cylc/cylc-doc.884/html/index.html
  • Follow up PR: Use these changes in cylc-flow/cylc/flow/cfgspec cylc/cylc-flow#7092

@wxtim
Copy link
Member

wxtim commented Nov 19, 2025

Please merge or request a second review...

@oliver-sanders oliver-sanders merged commit 2a19b28 into cylc:master Nov 21, 2025
1 check passed
@oliver-sanders oliver-sanders deleted the 226 branch November 21, 2025 10:25
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.

document environment variables

2 participants