.. _user_guide:

==========
User Guide
==========

From installation to advanced customization—everything you need to use Phil effectively.

Getting Started
---------------

.. grid:: 1 2 2 2
   :gutter: 3
   :padding: 2 2 0 0

   .. grid-item-card:: :octicon:`download` Installation
      :link: userGuides/installation
      :link-type: doc
      :class-card: intro-card
      :shadow: md

      Install Phil and verify your setup.

   .. grid-item-card:: :octicon:`rocket` Quickstart
      :link: userGuides/quickstart
      :link-type: doc
      :class-card: intro-card
      :shadow: md

      Impute your first dataset in 5 minutes.

   .. grid-item-card:: :octicon:`code` Programmatic API
      :link: userGuides/programmatic
      :link-type: doc
      :class-card: intro-card
      :shadow: md

      Full control over Phil's configuration.

Going Deeper
------------

.. grid:: 1 2 2 2
   :gutter: 3
   :padding: 2 2 0 0

   .. grid-item-card:: :octicon:`tools` Intermediate
      :link: userGuides/intermediate
      :link-type: doc
      :class-card: intro-card
      :shadow: md

      Tuning imputation strategies and candidate counts.

   .. grid-item-card:: :octicon:`beaker` Advanced
      :link: userGuides/advanced
      :link-type: doc
      :class-card: intro-card
      :shadow: md

      Custom strategies and descriptor configuration.

Production & Quality
--------------------

.. grid:: 1 2 2 2
   :gutter: 3
   :padding: 2 2 0 0

   .. grid-item-card:: :octicon:`checklist` Best Practices
      :link: userGuides/best_practices
      :link-type: doc
      :class-card: intro-card
      :shadow: md

      Recommended workflows and common pitfalls.

   .. grid-item-card:: :octicon:`verified` Testing
      :link: userGuides/testing
      :link-type: doc
      :class-card: intro-card
      :shadow: md

      Validate imputation quality and reproducibility.

.. toctree::
   :maxdepth: 2
   :caption: Guides
   :hidden:

   userGuides/installation
   userGuides/quickstart
   userGuides/programmatic
   userGuides/intermediate
   userGuides/advanced
   userGuides/best_practices
   userGuides/testing