Improve the main readme, supporting both users willing to clone and run
samples, developers looking to create a new app using the nuget package,
and contributors looking for ways to participate.
Added additional technical docs, explaining some important concepts and
touching on various aspects of the project, e.g. architecture and
nomenclature.
