Dev docs

[alecandido]

Some words about the organization of the package could be appreciated by future developers (including our future selves).

This could fit inside the docs #30, for the part concerning the overall organization. However, for more specific info, module docstrings are a great place to describe the content with a broader perspective.