[Python] Fix typos in docstrings and extend documentation

[g3bk47]

Changes proposed in this pull request

Add equations to the equivalence_ratio and mixture_fraction functions in the python docstrings and fix some formatting typos

• The pull request includes a clear description of this code change
• Commit messages have short titles and reference relevant issues
• Build passes (scons build & scons test) and unit tests address code coverage
• Style & formatting of contributed code follows contributing guidelines
• The pull request is ready for review

[decaluwe]

Many thanks for catching and tackling this, @g3bk47 ! I think most of these are straightforward. I made one suggestion to make the notation used in the explanation of the mole fractions equation match that used in the equation (which you self-correct, in the mass-fraction version).

Other than that, this looks good to go. Thanks again!

[g3bk47]

Thanks, @decaluwe! I commited your suggestion

[decaluwe]

Thanks, @g3bk47 - this all LGTM. I'm not sure why the CI/Coverage test is failing. Once that clears up, I'll go ahead and merge.

Are you already added to AUTHORS.md? I am guessing you are, but thought I'd ask.

[ischoegl]

@g3bk47 and @decaluwe ... I retriggered the failing tests and they now pass - so it was just some temporary GitHub issue. Thanks for the fix!

[g3bk47]

Yes, I am already listed in the authors file (https://github.com/Cantera/cantera/blob/main/AUTHORS#L63)

[ischoegl]

On second look, I noticed that the docs are currently not building - could you please address? There are some warnings about block quotes, see https://github.com/Cantera/cantera/runs/7361821505?check_suite_focus=true

Other than that, a couple of lines go beyond our 88 character limit.

[g3bk47]

@ischoegl You are right, the comment strings need to be raw strings due to the latex syntax. I built the sphinx documentation locally and it seems to work now

[ischoegl]

Was about to merge, but found one stray quotation mark

[g3bk47]

Good catch, thanks!