Skip to content

content: simplify index page and remove redundant sections #31

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sbaerlocher merged 2 commits into from
Mar 10, 2026
Merged

content: simplify index page and remove redundant sections #31

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0f0e97b
content: simplify index page and remove redundant sections
sbaerlocher Mar 10, 2026
2e96c60
fix: remove broken quickstart link from footer CTA
sbaerlocher Mar 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
120 changes: 12 additions & 108 deletions rst/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,23 +28,22 @@ Production-ready Ansible collections, container images, and development tools fo

----

.. _features:

.. raw:: html

<div class="feature-grid">
<div class="feature-card">
<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
Copy Markdown

@claude claude Bot Mar 10, 2026

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.

<div class="feature-card">
<h3>📚 Complete Examples</h3>
<p>Production-ready playbooks for web stacks, Kubernetes, monitoring, and more.</p>
<a href="guide/tutorials/examples.html" class="btn-primary">View Examples →</a>
</div>
<div class="feature-card">
<h3>🔒 Security First</h3>
<p>Built-in security best practices, hardening guides, and compliance patterns.</p>
<a href="guide/best-practices/security.html" class="btn-primary">Security Guide →</a>
</div>
</div>

Expand Down Expand Up @@ -156,6 +155,8 @@ Installation Options

----

.. _popular-use-cases:

Popular Use Cases
-----------------

Expand Down Expand Up @@ -185,6 +186,8 @@ Real-world scenarios with complete, working examples:

----

.. _platform-components:

Platform Components
-------------------

Expand Down Expand Up @@ -256,6 +259,8 @@ GitHub Actions

----

.. _landing-architecture:

Architecture & Design
---------------------

Expand Down Expand Up @@ -291,6 +296,8 @@ Architecture & Design

----

.. _features-quality:

Features & Quality
------------------

Expand Down Expand Up @@ -350,75 +357,7 @@ Features & Quality

----

Documentation Hub
-----------------

.. raw:: html

<div class="doc-hub-grid">
<!-- Getting Started Section -->
<div class="doc-hub-section">
<h3>🚀 Getting Started</h3>
<div class="doc-links">
<a href="guide/getting-started/quickstart.html" class="doc-link">
<span class="doc-title">Quick Start Guide</span>
<span class="doc-description">Get up and running in 5 minutes</span>
</a>
<a href="guide/getting-started/environment.html" class="doc-link">
<span class="doc-title">Development Environment</span>
<span class="doc-description">Set up your development environment</span>
</a>
<a href="guide/getting-started/architecture.html" class="doc-link">
<span class="doc-title">Platform Architecture</span>
<span class="doc-description">Understand the platform design</span>
</a>
</div>
</div>

<!-- Working with arillso Section -->
<div class="doc-hub-section">
<h3>📚 Working with arillso</h3>
<div class="doc-links">
<a href="guide/tutorials/use-cases.html" class="doc-link">
<span class="doc-title">Use Cases</span>
<span class="doc-description">10+ real-world scenarios</span>
</a>
<a href="guide/tutorials/examples.html" class="doc-link">
<span class="doc-title">Complete Examples</span>
<span class="doc-description">Complete playbook examples</span>
</a>
<a href="guide/best-practices/security.html" class="doc-link">
<span class="doc-title">Security Best Practices</span>
<span class="doc-description">Security best practices</span>
</a>
</div>
</div>

<!-- Reference Section -->
<div class="doc-hub-section">
<h3>📖 Reference</h3>
<div class="doc-links">
<a href="guide/reference/compatibility.html" class="doc-link">
<span class="doc-title">Compatibility Matrix</span>
<span class="doc-description">Version compatibility matrix</span>
</a>
<a href="guide/reference/troubleshooting.html" class="doc-link">
<span class="doc-title">Troubleshooting</span>
<span class="doc-description">FAQ and debugging guide</span>
</a>
<a href="guide/best-practices/standards.html" class="doc-link">
<span class="doc-title">Repository Standards</span>
<span class="doc-description">Repository standards</span>
</a>
<a href="guide/development/contributing.html" class="doc-link">
<span class="doc-title">Contributing Guide</span>
<span class="doc-description">Contribution guidelines</span>
</a>
</div>
</div>
</div>

----
.. _community:

Community & Support
-------------------
Expand Down Expand Up @@ -473,39 +412,6 @@ Community & Support
</div>
</div>

**Get Help:**

* **Documentation Issues?** Open an issue on `guide repository <https://github.com/arillso/guide>`_
* **Bug Reports?** Use the issue tracker in the respective project repository
* **Questions?** Check :doc:`guide/reference/troubleshooting` first
* **Contributing?** Read :doc:`guide/development/contributing`

----

Statistics
----------

.. raw:: html

<div class="stats-grid">
<div class="stat-card">
<h3>24+</h3>
<p>Production Roles</p>
</div>
<div class="stat-card">
<h3>10+</h3>
<p>Plugins & Filters</p>
</div>
<div class="stat-card">
<h3>80%+</h3>
<p>Code Coverage</p>
</div>
<div class="stat-card">
<h3>100%</h3>
<p>Open Source</p>
</div>
</div>

----

.. toctree::
Expand Down Expand Up @@ -596,9 +502,7 @@ Copyright (c) 2022-2026, arillso
<h3>Ready to Get Started?</h3>
<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>
<a href="guide/tutorials/examples.html" class="btn-secondary-lg">View Examples</a>
<a href="collections/index.html" class="btn-secondary-lg">Browse Collections</a>
<a href="collections/index.html" class="btn-primary-lg">Browse Collections</a>
</div>
</div>
<div class="footer-links">
Expand Down