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

The User Guide teaches CongoCC through worked examples and task-oriented
how-to guides, with deeper explanations of how the tool works. Start with
Installation and the tutorial, then dip into the how-to guides as needed.

.. toctree::
   :maxdepth: 1

   installation

.. toctree::
   :maxdepth: 1
   :caption: Tutorial

   tutorial/first-grammar
   tutorial/calculator
   tutorial/json
   tutorial/beyond

.. toctree::
   :maxdepth: 1
   :caption: How-To Guides

   howto/tokens
   howto/choices
   howto/trees
   howto/project-structure
   howto/build-integration
   howto/testing
   howto/context-sensitive
   howto/large-inputs
   howto/fault-tolerance

.. toctree::
   :maxdepth: 1
   :caption: Explanation

   explanation/parsing-model
   explanation/lexer-internals
   explanation/philosophy
   explanation/freemarker

.. toctree::
   :maxdepth: 1
   :caption: Getting Help

   troubleshooting
   faq
   migration