Add Scaladoc and developers' documentation

As most of the development was still considered experimental until now (see !1 (merged)), close to no documentation on how the generator works was provided. However this is not an acceptable situation and should be addressed quickly.