Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve CRANE Documentation #93

Open
4 of 10 tasks
smpeyres opened this issue Apr 5, 2023 · 1 comment
Open
4 of 10 tasks

Improve CRANE Documentation #93

smpeyres opened this issue Apr 5, 2023 · 1 comment
Assignees
Labels
enhancement New feature or request

Comments

@smpeyres
Copy link
Collaborator

smpeyres commented Apr 5, 2023

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.
  • Set up ReadTheDocs website (Completed by @dcurreli, commit fc77a79)
  • Put link in repo (Completed by @smpeyres)
  • Flesh out "running" (Completed by @smpeyres, commit c2f0ccd)
  • Flesh out "tutorials" page (see below)
  1. 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.
  • 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)
  1. (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.
  • User guide: Obtain .tex file to current user guide pdf, if possible. If not, be prepared to re-write it.
  • User guide: Include various examples (ZDPlasKin, Lorentz, CRM) with extended theory/explanation.
  • User guide: Practical guidelines for plasma chemistry modeling.
@smpeyres smpeyres added the enhancement New feature or request label Apr 5, 2023
@dcurreli
Copy link
Contributor

dcurreli commented Apr 5, 2023

This will be of great help, thank you Sean!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants