"""""""""""""""""""""""
Online Examples Library
"""""""""""""""""""""""

Examples of Dakota inputs, drivers, and related tools along with explanations
are provided in our `Examples Library <https://github.com/snl-dakota/dakota-examples/>`__.

============
Organization
============

Examples are organized topically in a hierarchy of folders. Each example (and in some
cases collection of examples) has a README, which is in markdown format.
This document includes a description of the example and other details, such as how to
run or use the example yourself.

Examples in the "official" folder were created or reviewd by Dakota project
team members and are tested. The "contributed" examples are those we believe
may be useful but have received a lower level of vetting.

(Some of the other folders you may encounter, such as ``cmake``, handle testing
and packaging and can be disregarded if you aren't a Dakota developer.)

============================
Contributing Dakota Examples
============================

If you've created an example that you feel may be of value to others, we invite you
to submit it for inclusion in the Library. Drop us a line on our
`Discussions page <https://github.com/orgs/snl-dakota/discussions>`__.

**See also:**

- :ref:`The Dakota GUI is a convenient and powerful way to view and find examples. <gui-examples-main>` It
  includes a text-based search interface to quickly search for examples.