Updated the samples and user-guide chapter to reflect improvements to Maven Publishing
Tweaks to design spec