v.1.2.1 release

Cleaned repository to meet the requirements of the Journal of Open Source Software.
No new features, but have added more examples, cleaned up the building process and added instructions for contributing.