docs: stop styling page references as blockquotes - #2666
Open
tonyandrewmeyer wants to merge 3 commits into
Open
Conversation
…outs Un-blockquote 'See more:', 'See also:', 'See first:', and 'Read more:' callouts across docs/howto, docs/explanation, and one tutorial page. References to other pages aren't quotes, so shouldn't be styled as quotes (per canonical/charmlibs#493).
charmlibs#493, which the issue cites, sets the rule: two items comma separated, three or more bulleted. Eight converted lines had three or more items but stayed on one line, including a five-item ops.ActionEvent list. Also converts the eight "> Examples:" blockquotes, which are references to charm source styled as quotes for the same historical reason. The tutorial's breadcrumb and "See previous"/"See next" blockquotes are navigation rather than references, and are left alone.
Vale skips blockquote contents, so unquoting these lines is what exposed "Charmlibs" and "timeframes" -- both were already in the docs. "Charmlibs" is a product name, so it goes in the custom wordlist alongside Jubilant's and Borescope. "timeframes" is reworded to "time frames", which is the form the US spellcheck accepts.
tonyandrewmeyer
marked this pull request as ready for review
July 27, 2026 04:05
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Replaces the
> See also:/> See more:/> See first:blockquotes throughoutdocs/with plain body text.Also converts the eight
> Examples:blocks, which point at charm source and are quote-styled for the same historical reason.Two related things left alone, each worth a separate decision:
> **See previous:**/> **See next:**blockquotes. Those are navigation rather than references, and the tutorial is being worked on separately at the moment.> Added in ops 2.15/> Added in ops 2.17version notes inmanage-pebble-health-checks.md.Fixes #2643