docs: add README to samples subdirectory (#639)

* streamline samples README outline * update comments in requester_pays_test * change list of samples to be collapsible * move readme to upper level for discoverability * add cloud shell to each sample * fix typo and links

Author: cojenco