Redesign homepage with infrastructure-first messaging#399
Draft
ericholscher wants to merge 4 commits into
Draft
Conversation
…tive Reorganize the homepage hierarchy so it leads with a clear positioning statement, two explicit audience paths (engineering teams vs open source), narrative-first value props, a named customer quote, a stated position on AI/LLMs, and trust signals (scale stats + 15 years in production). Features are demoted to layer-3 proof below the fold. Adds a small #homepage CSS scope for hero fineprint and the scale strip. https://claude.ai/code/session_01Xq2jGSBae9jxVwb6HzpDWt
Rework v1 of the homepage revamp based on review:
- Replace scattered inline styles with native SUI classes only
- Add proper two-card audience split section ("For engineering teams" /
"For open source projects") below the hero instead of encoding it only
in hero buttons
- Keep hero CTA simple and consistent with the original ("Get started for
free" / "Explore features") instead of audience-specific buttons
- Strip verbose Jinja comments to keep the template scannable
- Pair testimonials side-by-side (Godot + UC Berkeley) in one section
- Keep bottom CTA simple and matching the original pattern
- Slim down LESS overrides to only the stats strip and AI card border
https://claude.ai/code/session_01Xq2jGSBae9jxVwb6HzpDWt
Documentation build overview
17 files changed ·
|
The CI build step failed because site.overrides was changed without rebuilding readthedocs_theme/static/css/site.css. Rebuilt with the project's node 14 toolchain so compiled assets match the LESS source. Visual upgrades to the homepage: - Audience path cards now use inverted teal/violet segments for stronger visual contrast and brand color reinforcement - Added two image-backed feature showcase sections (versioned docs flyout and PR visual diff) using the header_image macro from the docs-as-code page, giving the page more visual depth - Added a decorative horizontal divider between logo strip and highlight blocks for cleaner section rhythm - Streamlined the AI stance section (removed redundant sub-label) All CI checks pass locally: lint, test, build-assets, pelican build, html-validate. https://claude.ai/code/session_01Xq2jGSBae9jxVwb6HzpDWt
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
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.
Summary
Redesigned the Read the Docs homepage to shift messaging from "docs as code" to "documentation infrastructure layer," emphasizing platform capabilities over features. Added new sections for audience segmentation, AI/LLM positioning, and trust signals while reorganizing the feature hierarchy.
Key Changes
Messaging & Positioning
New Sections
llms.txtsupport and RAG-ready infrastructureContent Reorganization
UI/Layout Updates
id="homepage"to body element for scoped stylingCopy Refinements
’for apostrophes)https://claude.ai/code/session_01Xq2jGSBae9jxVwb6HzpDWt