Skip to content

Conversation

negz
Copy link
Member

@negz negz commented Aug 14, 2025

In addition to #973 I'd like to auto-generate a list on each index page. This is because it's possible to browse to the index pages, even if you can't do it by the sidebar. For example the top-level index page links to top-level get started, not to a specific get started guide.

This PR:

  • Adds code to automatically generate a list of child/sibling pages
  • Uses it in index.md files
  • Updates many page front-matter descriptions for succinctness and clarity, since they'll now appear in the lists

Copy link

netlify bot commented Aug 14, 2025

Deploy Preview for crossplane ready!

Name Link
🔨 Latest commit d34b276
🔍 Latest deploy log https://app.netlify.com/projects/crossplane/deploys/689e40faa3adfe0008d3213c
😎 Deploy Preview https://deploy-preview-974--crossplane.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 96 (🟢 up 3 from production)
Accessibility: 90 (🔴 down 2 from production)
Best Practices: 92 (no change from production)
SEO: 100 (no change from production)
PWA: 70 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

This way when folks browse to the index pages they'll see an
auto-generated list of child pages.

Signed-off-by: Nic Cope <[email protected]>
@negz negz changed the title WIP: Auto-generate child page indexes Auto-generate child page indexes Aug 14, 2025
negz added 2 commits August 14, 2025 11:41
* Keep them concise (~50 chars) for rendering on index pages
* Adjust them for clarity and accuracy
* Add descriptions to pages that were missing them

Signed-off-by: Nic Cope <[email protected]>
@negz negz marked this pull request as ready for review August 14, 2025 19:20
These weren't introduced by this PR - I think they were missed in recent
ones.

Signed-off-by: Nic Cope <[email protected]>
@negz negz merged commit 0314e64 into crossplane:master Aug 14, 2025
7 checks passed
@negz negz deleted the index branch August 14, 2025 20:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants