Document the GEM packages

Summary

At the moment, the different GEM packages are not well documented, and thus newer (and older) developers have difficulties understanding their structure.

Clear documentation should be written. If incoherencies are found, they should be fixed in both the documentation and code base.

What is the expected correct behavior?

Clear documentation about the GEM package exists and corresponds to the code base.