DOC: refinamento da documentação e do README

Documentar o código a fim de torná-lo entendível para as próximas gerações.

uma refatoração do README é necessária e urgente.

links para se inspirar 🔥🔥🔥

https://en.wikipedia.org/wiki/Zen_of_Python
https://blog.codacy.com/code-documentation
https://www.builtinnyc.com/articles/mantras-clean-code-best-practices