update documentation

update documentation, have real examples of each function, and then move the main code to a new section, doc-blocks are not helping on readme, rather have calls

Comienza con el README y los bloques de documentación de funciones existentes para identificar cada función que necesita un ejemplo y cómo se presenta actualmente el código principal. El trabajo estará terminado cuando el README tenga una nueva sección main-code, use ejemplos basados en llamadas para cada función y ya no dependa de la presentación actual de los doc-blocks.

Escrito por el modelo de indexación a partir del texto del issue.