style(api): Revise execute/simulate reference docstrings

[SyntaxColoring]

Overview

Minor adjustments to the reference docstrings in opentrons.simulate and opentrons.execute.

Test Plan and Hands on Testing

I've skimmed the generated docs and made sure this doesn't introduce any flagrant formatting problems.

Changelog

• Note, for a couple of arguments, that they are only intended for internal Opentrons use.
• Adjust indentation so we don't have to describe every parameter with ~50-character-long lines. (No user-visible difference, just changing the formatting in the .py file.)
• A couple other tiny fixups, like Python instead of python.

Review requests

Is chore_release-8.0.0 the correct merge target?

Risk assessment

No risk.

[sfoster1]

Yeah, that looks like a good set of changes

[ecormany]

Looks good, only improves things — although I spotted a couple more formatting changes you could add.

Maybe the rare opportunity for "style(api)" in the PR title.

[SyntaxColoring]

Maybe the rare opportunity for "style(api)" in the PR title.

oooo rare commit tag, gimme

[jwwojak]

Guys, I'm not sure where or how this text appears, but would recommend changing the last part of the sentence "and is best not used" to something like "and should not be used."

Or

Try 2 shorter sentences, "This is in preparation for a beta feature. Do not use it."

[jwwojak]

Another "best not used" phrase. From my suggestion above, I'd recommend changing that part of the sentence to something like "and should not be used."

Or, try 2 shorter sentences, "This is in preparation for a beta feature. Do not use it." A stronger admonition if people shouldn't use this.

[jwwojak]

Added some suggestions for consideration.