docs: fix typos

[Mo-Gul]

and improve some formatting/style.

[Mo-Gul]

Other things can be harmonized as well, e.g. the use of d in \int ... dx. There is one instance of an upright d

Clapeyron.jl/docs/src/theory/background.md

Line 29 in 529af13

``A_\mathrm{ideal} =- \int p\,\mathrm{d}V =- Nk_\mathrm{B}T\ln{V}+c(T,N)``

The other (five) instances (just) use the normal math d (italics).

[longemen3000]

Thanks!
on the use of italics vs upright d, feel free to add those changes here or in another PR. I'm going to merge this tomorrow.

[Mo-Gul]

What I have also noticed is that you (sometimes) write "personal names" in small letters like "antonine"

Clapeyron.jl/docs/src/user_guide/custom_methods.md

Line 47 in 529af13

For saturation solvers ([`saturation_pressure`](@ref),[`saturation_temperature`](@ref)), You can dispatch on a different saturation method. let's create one, that just evaluates antoine coefficients:

or "helmholtz"

Clapeyron.jl/docs/src/properties/basic.md

Line 19 in 529af13

Almost all models in Clapeyron based on helmholtz free energy have at least one of the following functions defined:

Is that on purpose?

[longemen3000]

Is that on purpose?
No haha, feel free to correct those docs.

[Mo-Gul]

Ok, one more thing I have noticed. Have a look at the items in https://clapeyronthermo.github.io/Clapeyron.jl/dev/user_guide/custom_methods/#Definitions

which is the output of

Clapeyron.jl/docs/src/user_guide/custom_methods.md

Lines 8 to 10 in 529af13

	- `[volume](@ref)(model, p, T, z)`: Obtains the volume of a system at a given temperature, pressure and composition. If the phase is unknown, it will find the vapour and liquid roots and return the one that minimises the Gibbs free energy. This function is called by all of our bulk property methods.
	- `[saturation_pressure](@ref)(model, T)`: Obtains the saturation pressures and volumes for a pure species.
	- `[crit_pure](@ref)(model)`: Obtains the critical point for a pure species.

I am guessing that the starts of the lines should look something similar to

[`volume(model, p, T, z)`](@ref)

right? But I don't have a clue if this gives the expected result.

[longemen3000]

I am guessing that the starts of the lines should look something similar to

i just checked the docs for Documenter.jl, and the correct syntax for those cases is actually:

[volume(model,p,T,z](@ref Clapeyron.volume)

https://documenter.juliadocs.org/stable/man/syntax/#Named-@refs

[Mo-Gul]

I'd say this is something for another PR which I leave up for you, just in case this doesn't work (directly). Are you fine with that?

[longemen3000]

yeah, i will test if that works later. in the meantime, i think this PR is ready to merge.

[pw0908]

Mind if I take a look before merging?

[pw0908]

@Mo-Gul thanks a lot for all of this! I looked over your modifications and have no issues with any of them.

If it is of interest to you, we are modifying the docs over on a separate branch. Progress has been slow, but we'd be grateful for any feedback you might provide!

[Mo-Gul]

Sure, but since I just forked the master branch it would be nice to first merge this PR. After that I'll refork and have a look.

Shall I start a discussion for general things about the docs or what would be a proper place for that?

[pw0908]

Done!

Discussion would probably be the best place for it.