doc(*): add readme content and update license

Updated the content of the readme with important instructions for
developers. Fixed up the license a bit and made some modifications to
the build related to doc generation.