Clarify updated /shutdown behavior including doc links

Resolves #14