Update READMEs and add #error directive to sample projects

* mostly a content re-factor to make the sample suitable for alt. getting-started.