-
Notifications
You must be signed in to change notification settings - Fork 94
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Fix.bad toml example in lint docstring #5843
Fix.bad toml example in lint docstring #5843
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
On master you removed TOMLDOC
from being appended to the docstring
cylc-flow/cylc/flow/scripts/lint.py
Lines 1275 to 1277 in 31150c9
__doc__ += TOMLDOC.format( | |
'\n\n.. code-block:: toml\n', str(LINT_SECTIONS)) + get_reference_rst( | |
parse_checks(['728', 'style'], reference=True)) |
This makes sense to me as it seems a bit out of place appearing in the docs like this:
Note that it still appears in the --help
text as that is done separately
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Did we have this discussion before? I'm not sure that I really wanted to do that. Or did we agree to put the Toml reference somewhere else. Perhaps it could do with a new page somewhere?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
31150c9
to
0991c63
Compare
…at_runtime * upstream/master: tui: avoid deprecated import (cylc#5858) Exclude broken pytest-asyncio version remove lint (cylc#5856) Async pipe decorator: preserve wrapped func signature Maintain order for CYLC_PYTHONPATH (cylc#5853) Update tests/integration/tui/conftest.py tests/i: fix flaky tui/test_updater tests (cylc#5849) tests/i: tui - attempt to stabilise tests Bump pypa/gh-action-pypi-publish from 1.8.10 to 1.8.11 (cylc#5851) tests/i: fix flaky tui/test_updater tests Improve changelog entries Fix bad TOML example in `cylc lint` docstring (cylc#5843) lint - S011 no longer warns against 0{{a}} (cylc#5841) `cylc lint`: add rule to catch `rose date` tui: show view tui: log view tui: tidy dangling interfaces tui: fix an obscure freezing issue tui: update screenshots Tui 1.0
Very small change to make Cylc Doc build correctly.