Skip to content

content: simplify index page and remove redundant sections#31

Merged
sbaerlocher merged 2 commits intomainfrom
content/simplify-index-page
Mar 10, 2026
Merged

content: simplify index page and remove redundant sections#31
sbaerlocher merged 2 commits intomainfrom
content/simplify-index-page

Conversation

@sbaerlocher
Copy link
Member

Summary

  • Remove Documentation Hub section (links to non-existent pages)
  • Remove Statistics section
  • Remove broken "Quick Start Guide", "View Examples", "Security Guide" links from feature cards
  • Add RST anchor labels (.. _features:, .. _community:, etc.) for cross-referencing
  • Remove "Get Help" text block (redundant with Community section)
  • Simplify footer CTA buttons

Test plan

  • Index page renders without Sphinx warnings
  • All remaining links resolve correctly
  • Anchor labels work for cross-references

Remove Documentation Hub and Statistics sections. Remove broken links
to non-existent pages. Add RST anchor labels for cross-referencing.
Streamline CTA buttons in footer.
<h3>🚀 Quick Start in Minutes</h3>
<p>Get started with arillso in under 5 minutes. Install collections, run your first playbook.</p>
<a href="guide/getting-started/quickstart.html" class="btn-primary">Quick Start Guide →</a>
</div>
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The feature cards now contain only a heading and paragraph with no actionable link. While removing the broken links is correct, consider whether these cards should be redesigned (e.g., as plain informational tiles without a card/button style) or left as placeholders until the target pages exist.

If they're intentional placeholders, a short comment like {# TODO: add link once quickstart page is created #} or an RST comment would help future contributors understand the intent.

rst/index.rst Outdated
@@ -597,7 +503,6 @@ Copyright (c) 2022-2026, arillso
<p>Choose your path and start automating your infrastructure today.</p>
<div class="cta-buttons">
<a href="guide/getting-started/quickstart.html" class="btn-primary-lg">Quick Start Guide</a>
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The PR description lists guide/getting-started/quickstart.html as one of the broken links, and it was correctly removed from the feature cards — but this footer CTA still references the same path. If the page doesn't exist yet, this link will also be broken and should either be removed or replaced with a working target (e.g., collections/index.html).

Suggested change
<a href="guide/getting-started/quickstart.html" class="btn-primary-lg">Quick Start Guide</a>
<a href="collections/index.html" class="btn-primary-lg">Get Started</a>

The quickstart page does not exist yet, so replace the footer CTA
with a single link to the collections page.
@sbaerlocher sbaerlocher merged commit 108363a into main Mar 10, 2026
2 checks passed
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.

1 participant