Update docs and README

[ppasupat]

Description

Updated the documentation and README.

• Refactored the action space and observation space from the "Python Usage" page.
• Added some missing details.

Type of change

Please delete options that are not relevant.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

Checklist:

• I have run the pre-commit checks with pre-commit run --all-files (see CONTRIBUTING.md instructions to set it up)
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[pseudo-rnd-thoughts]

Looks great to me, the only thing that I noticed is on the PyPI repo, if we know what we want it to be called then we should claim it with a dummy setup just in case