Better documentation

Well, the title of the issue tells it all, but just to clarify, we may need a better documentation (something in the read the docs or something like that, or a github page)

It is going to be a tricky work and a very necessary one.

The issue names no files, tests, or documentation entry point; begin by reviewing the repository's existing documentation and deciding whether Read the Docs or a GitHub page is in scope. Done means the project has a clearly defined, substantially improved documentation site or set of pages, but the issue needs scope and acceptance criteria before work can start.

Written by the indexing model from the issue text.