docs: describe the lifetime of discovery url

fixes #1599 
k