Galaxy Workflow Format 2
========================

**gxformat2** is the reference library for Galaxy's human-friendly YAML workflow format.
It converts between Format2 (YAML) and native Galaxy (.ga) representations, provides
linting, normalization, and Pydantic-based validation.

.. grid:: 2

    .. grid-item-card:: Getting Started
        :link: installation
        :link-type: doc

        Install gxformat2 and write your first Format2 workflow.

    .. grid-item-card:: Usage Guide
        :link: usage
        :link-type: doc

        Conversion, linting, normalization, and validation.

    .. grid-item-card:: CLI Reference
        :link: cli
        :link-type: doc

        Command-line tools for working with workflows.

    .. grid-item-card:: Workflow Examples
        :link: examples
        :link-type: doc

        Browseable catalog of workflow fixtures with visualizations.

.. toctree::
   :maxdepth: 2
   :caption: User Guide
   :hidden:

   Format 2 <readme>
   Installation <installation>
   Usage <usage>
   CLI <cli>

.. toctree::
   :maxdepth: 2
   :caption: Reference
   :hidden:

   Format 2 Schema <https://galaxyproject.github.io/gxformat2/v19_09.html>
   Native Schema <https://galaxyproject.github.io/gxformat2/native_v0_1.html>
   Examples <examples>
   Design <design>

.. toctree::
   :maxdepth: 2
   :caption: Development
   :hidden:

   Contributing <contributing>
   Developing <developing>
   Conduct <conduct>
   History <history>

Galaxy Ecosystem
----------------

- `Galaxy Project <https://galaxyproject.org>`_ -- open-source platform for data-intensive research
- `IWC <https://iwc.galaxyproject.org>`_ -- Intergalactic Workflow Commission, curated community workflows
- `Planemo <https://planemo.readthedocs.io>`_ -- CLI for Galaxy tool and workflow development
- `Galaxy Training Network <https://training.galaxyproject.org>`_ -- tutorials and training materials


Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`