Documentation needs to be improved:

Some examples of docs made using MkDocs Material:

https://github.com/pydantic/pydantic/blob/main/mkdocs.yml