docs: describe the lifetime of discovery url

fixes #1599 
Move this before the two use cases and Change ## to ###?