improve documentation

[martavp]

Using Supplemental Materials from:

https://doi.org/10.1016/j.joule.2022.04.016

and

https://doi.org/10.1016/j.joule.2022.04.016

[martavp]

A few of us at Aarhus are working on this and plan to suggest a major revision of current documentation in the following weeks.