DOCS: Review code examples in docs to improve legibility

[pydanny]

Autoformatting of Python code, especially Air tags is problematic in our docs. Especially for beginners. We can turn off the autoformatting of our docstrings using this technique:

<!-- blacken-docs:off -->
```python
# whatever you want
```
<!-- blacken-docs:on -->

Reference: https://github.com/adamchainz/blacken-docs?tab=readme-ov-file#markdown