Replaced the docs hero with a value-led marketing diagram and narrowed demo videos to 80 columns.#2769
Conversation
The README and social preview image now use a value and outcome-led hero. The architecture page keeps its original 'system components' diagram, restored under 'diagram-components-dark.png' and 'diagram-components-light.png'. The self-contained HTML source lives at '.vortex/docs/static/img/diagram.html' for future edits.
WalkthroughThis PR reduces terminal recording width from 140 to 80 columns for build, provision, lint, test, and test-bdd videos, regenerates the corresponding static JSON transcripts, updates architecture diagram image references, and adds a new standalone diagram.html page with theme toggling. ChangesDocs assets and recording width update
Estimated code review effort: 2 (Simple) | ~10 minutes Possibly related PRs
Suggested labels: Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches📝 Generate docstrings
🧪 Generate unit tests (beta)
Warning There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure. 🔧 Biome (2.5.1).vortex/docs/static/img/lint.jsonFile contains syntax errors that prevent linting: Line 2: End of file expected; Line 3: End of file expected; Line 4: End of file expected; Line 5: End of file expected; Line 6: End of file expected; Line 7: End of file expected; Line 8: End of file expected; Line 9: End of file expected; Line 10: End of file expected; Line 11: End of file expected; Line 12: End of file expected; Line 13: End of file expected; Line 14: End of file expected; Line 15: End of file expected; Line 16: End of file expected; Line 17: End of file expected; Line 18: End of file expected; Line 19: End of file expected; Line 20: End of file expected; Line 21: End of file expected; Line 22: End of file expected; Line 23: End of file expected; Line 24: End of file expected; Line 25: End of file expected; Line 26: End of file expected; Line 27: End of file expected; Line 28: End of file expected; Line 29: End of file expected; Line 30: End of file expected; Line 31: End of file expected; Line 32: End of file expected; Line 33: End of file expected; Line 34: End of file expected; Line 35: End of file expected; Line 36: End of file expected; Line 37: End of file expected; Line 38: End of file expected; Line 39: End of file expected; Line 40: End of file expected; Line 41: End of file expected; Line 42: End of file expected; Line 43: End of file expected; Line 44: End of file expected; Line 45: End of file expected; Line 46: End of file expected; Line 47: End of file expected; Line 48: End of file expected; Line 49: End of file expected; Line 50: End of file expected; Line 51: End of file expected; Line 52: End of file expected; Line 53: End of file expected; Line 54: End of file expected; Line 55: End of file expected; Line 56: End of file expected; Line 57: End of file expected .vortex/docs/static/img/provision.jsonFile contains syntax errors that prevent linting: Line 2: End of file expected; Line 3: End of file expected; Line 4: End of file expected; Line 5: End of file expected; Line 6: End of file expected; Line 7: End of file expected; Line 8: End of file expected; Line 9: End of file expected; Line 10: End of file expected; Line 11: End of file expected; Line 12: End of file expected; Line 13: End of file expected; Line 14: End of file expected; Line 15: End of file expected; Line 16: End of file expected; Line 17: End of file expected; Line 18: End of file expected; Line 19: End of file expected; Line 20: End of file expected; Line 21: End of file expected; Line 22: End of file expected; Line 23: End of file expected; Line 24: End of file expected; Line 25: End of file expected; Line 26: End of file expected; Line 27: End of file expected; Line 28: End of file expected; Line 29: End of file expected; Line 30: End of file expected; Line 31: End of file expected; Line 32: End of file expecte ... [truncated 2782 characters] ... ; Line 122: End of file expected; Line 123: End of file expected; Line 124: End of file expected; Line 125: End of file expected; Line 126: End of file expected; Line 127: End of file expected; Line 128: End of file expected; Line 129: End of file expected; Line 130: End of file expected; Line 131: End of file expected; Line 132: End of file expected; Line 133: End of file expected; Line 134: End of file expected; Line 135: End of file expected; Line 136: End of file expected; Line 137: End of file expected; Line 138: End of file expected; Line 139: End of file expected; Line 140: End of file expected; Line 141: End of file expected; Line 142: End of file expected; Line 143: End of file expected; Line 144: End of file expected; Line 145: End of file expected; Line 146: End of file expected .vortex/docs/static/img/test.jsonFile contains syntax errors that prevent linting: Line 2: End of file expected; Line 3: End of file expected; Line 4: End of file expected; Line 5: End of file expected; Line 6: End of file expected; Line 7: End of file expected; Line 8: End of file expected; Line 9: End of file expected; Line 10: End of file expected; Line 11: End of file expected; Line 12: End of file expected; Line 13: End of file expected; Line 14: End of file expected; Line 15: End of file expected; Line 16: End of file expected; Line 17: End of file expected; Line 18: End of file expected; Line 19: End of file expected; Line 20: End of file expected; Line 21: End of file expected; Line 22: End of file expected; Line 23: End of file expected; Line 24: End of file expected; Line 25: End of file expected; Line 26: End of file expected; Line 27: End of file expected; Line 28: End of file expected; Line 29: End of file expected; Line 30: End of file expected; Line 31: End of file expected; Line 32: End of file expecte ... [truncated 2814 characters] ... ; Line 123: End of file expected; Line 124: End of file expected; Line 125: End of file expected; Line 126: End of file expected; Line 127: End of file expected; Line 128: End of file expected; Line 129: End of file expected; Line 130: End of file expected; Line 131: End of file expected; Line 132: End of file expected; Line 133: End of file expected; Line 134: End of file expected; Line 135: End of file expected; Line 136: End of file expected; Line 137: End of file expected; Line 138: End of file expected; Line 139: End of file expected; Line 140: End of file expected; Line 141: End of file expected; Line 142: End of file expected; Line 143: End of file expected; Line 144: End of file expected; Line 145: End of file expected; Line 146: End of file expected; Line 147: End of file expected
Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.vortex/docs/static/img/diagram.html:
- Around line 100-108: The trust list in the diagram markup repeats the same
inline checkmark SVG in each .trust .item, making the source harder to maintain.
Refactor the repeated SVG in the diagram HTML by defining the checkmark once
with a reusable symbol/asset and referencing it from each item, so future icon
changes only need to be made in one place.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Repository UI
Review profile: ASSERTIVE
Plan: Pro Plus
Run ID: 8dee9972-072e-4313-a34b-121332db24a0
⛔ Files ignored due to path filters (16)
.vortex/docs/static/img/build.pngis excluded by!**/*.png.vortex/docs/static/img/build.svgis excluded by!**/*.svg.vortex/docs/static/img/diagram-components-dark.pngis excluded by!**/*.png.vortex/docs/static/img/diagram-components-light.pngis excluded by!**/*.png.vortex/docs/static/img/diagram-dark.pngis excluded by!**/*.png.vortex/docs/static/img/diagram-light.pngis excluded by!**/*.png.vortex/docs/static/img/installer.pngis excluded by!**/*.png.vortex/docs/static/img/installer.svgis excluded by!**/*.svg.vortex/docs/static/img/lint.pngis excluded by!**/*.png.vortex/docs/static/img/lint.svgis excluded by!**/*.svg.vortex/docs/static/img/provision.pngis excluded by!**/*.png.vortex/docs/static/img/provision.svgis excluded by!**/*.svg.vortex/docs/static/img/test-bdd.pngis excluded by!**/*.png.vortex/docs/static/img/test-bdd.svgis excluded by!**/*.svg.vortex/docs/static/img/test.pngis excluded by!**/*.png.vortex/docs/static/img/test.svgis excluded by!**/*.svg
📒 Files selected for processing (9)
.vortex/docs/.utils/update-videos.php.vortex/docs/content/architecture.mdx.vortex/docs/static/img/build.json.vortex/docs/static/img/diagram.html.vortex/docs/static/img/installer.json.vortex/docs/static/img/lint.json.vortex/docs/static/img/provision.json.vortex/docs/static/img/test-bdd.json.vortex/docs/static/img/test.json
|
Code coverage (threshold: 90%) Per-class coverage |
This comment has been minimized.
This comment has been minimized.
2 similar comments
This comment has been minimized.
This comment has been minimized.
|
Code coverage (threshold: 90%) Per-class coverage |
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #2769 +/- ##
==========================================
- Coverage 86.69% 86.25% -0.45%
==========================================
Files 96 89 -7
Lines 4727 4568 -159
Branches 47 3 -44
==========================================
- Hits 4098 3940 -158
+ Misses 629 628 -1 ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
|
📖 Documentation preview for this pull request has been deployed to Netlify: https://6a49ee37fff81b7ca5339960--vortex-docs.netlify.app This preview is rebuilt on every commit and is not the production documentation site. |
AlexSkrypnyk
added
the
Needs review
1 participant
Summary
Replaces the docs and README hero image with a value-led marketing diagram that communicates what Vortex offers (standardize every project, set up in minutes, effortless upgrades, centralized documentation) instead of showing internal system architecture, and keeps the former technical diagram available under new filenames linked from the Architecture page. Because the hero file also drives the site-wide
og:image, social-share previews of the docs site (LinkedIn, Slack, etc.) will show the new marketing diagram once this is deployed. Separately, all six terminal demo videos are re-recorded at 80 columns (down from 140) so they read more legibly on docs pages and on mobile.Changes
New marketing hero (
.vortex/docs/static/img/)diagram-dark.pnganddiagram-light.png(2880x1800) now render a value-proposition diagram: eyebrow "One foundation for every project", headline "Install once. Stay current for years.", four value cards (Standardize every Drupal project / Set up in minutes / Effortless upgrades / Centralized documentation), a trust bar (AI-agent ready, Free & open source, A tested toolchain, A new release every month), and a footer about portfolio consistency.diagram.html, the self-contained source used to render both PNGs - open the file for the dark variant, append#lightto the URL for the light variant, and screenshot at 2x per the file's own header comment.Preserved technical diagram
diagram-components-dark.pnganddiagram-components-light.png..vortex/docs/content/architecture.mdxrepoints its<img>sources to those new filenames so the Architecture page still shows the technical diagram.Social-share side effect
.vortex/docs/docusaurus.config.jsalready sets the site-wideimage: 'img/diagram-dark.png'used for og:image link previews - no code change was required, but this PR changes what that file contains, so previews now surface the new marketing diagram instead of the old technical one.Demo video terminal width (
.vortex/docs/.utils/update-videos.php)colsfrom140to80for all six recordings (installer,build,provision,lint,test,test-bdd)..jsonasciicast,.svg, and.pngposter for each of the six videos) at the new width.Screenshots
The six demo-video poster frames were also regenerated at the new 80-column width - see the
.pngfiles under.vortex/docs/static/img/in the diff.Before / After
Summary by CodeRabbit