docs: fix broken .style/ link and lift details block out of list item [DOCS-661] - #28180
Merged
nickvigilante merged 2 commits intoAug 20, 2026
Conversation
- documentation.md: the Vale style-guide link pointed at docs/.style/style-guide/, which is excluded from the published docs corpus, so the relative link 404s on the live site. Repoint it to an absolute github.com URL. - monitoring.md: lift the "Possible client values" <details> block out of the list item so it renders as a top-level accordion, and restore the dropped blockquote continuation marker.
Contributor
Docs previewCheck off each page once it's been reviewed. If a page changes in a later push, its checkbox clears automatically so it gets a fresh look. Pages not yet wired into the docs navigation aren't listed here. |
nickvigilante
marked this pull request as ready for review
August 14, 2026 18:31
nickvigilante
enabled auto-merge (squash)
August 14, 2026 18:31
bpmct
approved these changes
Aug 20, 2026
…x-broken-style-inter-doc-link-and-details-in-list # Conflicts: # docs/ai-coder/ai-gateway/monitoring.md
nickvigilante
deleted the
vigilante/docs-661-fix-broken-style-inter-doc-link-and-details-in-list
branch
August 20, 2026 19:09
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 subscribe to this conversation on GitHub.
Already have an account?
Sign in.
2 participants
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.
What
Two small docs fixes, split out of the offlinedocs Fumadocs migration (#27390) so that PR stays a focused tooling change and these land on their own review track.
docs/about/contributing/documentation.md: the Vale style-guide link pointed atdocs/.style/style-guide/, which is excluded from the published docs corpus, so the relative link 404s on the live site. Repointed to an absolute github.com URL.docs/ai-coder/ai-gateway/monitoring.md: lifted the "Possible client values"<details>block out of the list item so it renders as a top-level accordion, and restored a dropped blockquote continuation marker (>).Why
Both are genuine docs bugs on their own:
.style/link is broken on the live site today, because that directory is intentionally excluded from the published corpus.<details>nested inside a list item renders inconsistently; lifting it to a sibling block is portable across renderers.They are also prerequisites for the offlinedocs Fumadocs migration, whose stricter build-time sync hard-fails on unmapped inter-doc links and only converts a
<details>to an accordion when it is a list sibling. Landing them here first lets the migration PR drop these two files on its next rebase.Validation
make fmt/markdownandmake lint/markdown: clean (via pre-commit-light).