Modules improvement

add few description to discuss how it should look like.
I added an entry in the TODO file for adding that developers-centric list and I will merge the PR with the whole cleanup.