Readme updates

[zmoon]

I wanted to add a note about the #54 upshot to the parameter descriptions. Also tried to make some things easier to read (IMO) in the readme by adding some more Markdown styling.

[jonashaag]

Thanks for the PR.

I think it is harder to read now. Maybe we can use italics like the Python docs?

[zmoon]

That's a good idea. Like italics when referring to parameters that are in the parameter list? That is a common rST style. Do you have a preference between _ and * for Markdown italic?

[jonashaag]

Yes and no :)

[jonashaag]

Awesome thanks, do you consider this ready to be merged?

[zmoon]

I also just thought to update the actions versions in the examples (e.g. actions/checkout to v3). Would you want provision-with-micromamba left as main? The caching examples would work with v12. If not interested in this I think it is fine to merge now.

[jonashaag]

Yes let's keep main but a new PR with the updates is welcome :) Also if you are looking to contribute even more let me know :-D