Repository navigation
Improve Dev Notes reading, browsing, and layout consistency - #82
Merged
Merged
Conversation
Documentation previewThe preview has been removed. |
johnnygreco
changed the title
johnnygreco
marked this pull request as ready for review
September 28, 2026 15:37
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.
Dev Notes now use metadata-generated article headers with consistent titles, subtitles, author bylines, and uncropped hero images. The index separates a spacious page introduction, author/category filters framed by dividers, and a larger featured note followed by a scrolling archive.
Readers can combine author and category filters, share filtered URLs, use browser Back/Forward, and navigate from article bylines. Categories are fixed to Announcements, Research, Case Studies, and Examples; invalid metadata fails generation before files are changed. Empty categories have an empty state, and the full index remains readable without JavaScript.
The site-wide visual review also fixes mobile footer overlap, breadcrumb clipping, narrow tables, navigation closing, keyboard skip links, and video playback. Authors supply metadata rather than manually formatting note headers; CI validates generated content and browser layouts.
Validation: clean documentation build and artifact checks; renderer and header tests; Chromium and WebKit coverage in both themes at five screen sizes, including filtering, history, refresh, byline navigation, and reading without JavaScript. Reviewed desktop/mobile screenshots and exercised navigation, search, code tabs/copying, transcripts, image links, and video playback.