tweak explanations
in samples/README
and release notes