Skip to content
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

Merged
merged 1 commit into from
Nov 23, 2023

Conversation

wxtim
Copy link
Member

@wxtim wxtim commented Nov 23, 2023

Very small change to make Cylc Doc build correctly.

@wxtim wxtim requested a review from MetRonnie November 23, 2023 13:27
@wxtim wxtim self-assigned this Nov 23, 2023
@wxtim wxtim added this to the cylc-8.2.4 milestone Nov 23, 2023
@wxtim wxtim added the doc Documentation label Nov 23, 2023
@wxtim wxtim changed the base branch from master to 8.2.x November 23, 2023 13:27
Copy link
Member

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

__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:

image

Note that it still appears in the --help text as that is done separately

Copy link
Member Author

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?

Copy link
Member

Choose a reason for hiding this comment

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

There is already a section on pyproject.toml at the bottom

image

@wxtim wxtim force-pushed the fix.bad_toml_example_in_lint_docstring branch from 31150c9 to 0991c63 Compare November 23, 2023 16:11
@MetRonnie MetRonnie merged commit 6ff67a4 into cylc:8.2.x Nov 23, 2023
@wxtim wxtim deleted the fix.bad_toml_example_in_lint_docstring branch November 24, 2023 09:25
wxtim added a commit to wxtim/cylc that referenced this pull request Dec 5, 2023
…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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc Documentation small
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants