lcpp-org / crane

A MOOSE application dedicated to general Chemical ReAction NEtworks for plasma chemistry and thermochemistry problems.
https://crane-plasma-chemistry.readthedocs.io/
GNU Lesser General Public License v2.1
21 stars 20 forks source link

Improve CRANE Documentation #93

Open smpeyres opened 1 year ago

smpeyres commented 1 year ago

With a growing CRANE user base, especially of experimentalists who want to model their plasma experiment's chemistry, it's becoming clear that CRANE's documentation needs to be expanded to help onboard new users with minimal 1-on-1 assistance.

I have identified several notable tasks that could significantly enhance CRANE's documentation, especially for new users.

  1. Set up and basic edits to ReadTheDocs.

    • [x] Set up ReadTheDocs website (Completed by @dcurreli, commit fc77a79)
    • [x] Put link in repo (Completed by @smpeyres)
    • [x] Flesh out "running" (Completed by @smpeyres, commit c2f0ccd)
    • [ ] Flesh out "tutorials" page (see below)
  2. Flesh out the tutorials on the ReadTheDocs to fully explain the setup and philosophy behind the three ZDPlasKin example used for testing, similar to ZDPlasKin's "Examples" tab on their webpage. In the future, more examples and tutorials can be added to explore different discharge types and chemical processes.

    • [x] Example 1 Two-Reaction Argon (Completed by @smpeyres, commit 61b0910)
    • [ ] Example 2 Argon Microdischarge
    • [ ] Example 3 Nitrogen Plasma with External E-Field and Electron Density (optional)
  3. (Maybe no longer be necessary with ReadTheDocs) Improve and expand the user guide. Currently has some functionality, but this is the perfect place to put what can't fit in the wiki. The non-ZDPlasKin based examples such as the Lorentz attractor and the hydrogen CRM featured in the ArXiv preprint can be included. General practical guidelines for plasma chemistry modeling should be included as well (start simple, keep units consistent, maintain quasineutrality, useful formulas, etc). Additionally, .tex file should be kept in repository along with the .pdf for easier updates down the line.

dcurreli commented 1 year ago

This will be of great help, thank you Sean!