.. ##
.. ## Copyright (c) 2026, Lawrence Livermore National Security, LLC and
.. ## other RADIUSS Project Developers. See the top-level COPYRIGHT file for
.. ## details.
.. ##
.. ## SPDX-License-Identifier: (MIT)
.. ##

*********
Overview
*********

Welcome to RADIUSS Shared CI! This section will help you get your CI pipeline
up and running quickly.

====================
Choose Your Journey
====================

New to RADIUSS Shared CI?
==========================

If you're setting up CI for the first time, start here:

1. :doc:`prerequisites` - Check that you have everything you need
2. :doc:`five-minute-setup` - Get a basic pipeline running quickly
3. :doc:`choosing-your-path` - Decide which machines and features to enable

Already Using RADIUSS Shared CI?
=================================

If you're using the legacy include-based approach and want to migrate to
components:

→ :doc:`../user_guide/components_migration`

Need Help?
==========

- **Quick lookup**: :doc:`../user_guide/quick-reference`
- **Understand concepts**: :doc:`../user_guide/concepts`
- **Troubleshooting**: :doc:`../user_guide/troubleshooting`

============
What's Next?
============

After completing the getting started guides, you can:

- **Customize your setup**: :doc:`../user_guide/setup-with-components`
- **Update version**: :doc:`../user_guide/how_to`
- **Enable performance testing**: :doc:`../reference/components/performance-pipeline`
- **Get help**: :doc:`../user_guide/troubleshooting` and :doc:`../user_guide/faq`

.. toctree::
   :maxdepth: 2
   :hidden:

   prerequisites
   five-minute-setup
   choosing-your-path