added example for 3rd party caveats
added hint for choosing a secret