Document notice versions API.

This should be a separate PR. Also are you okay with renaming `?token=TOKEN` to `?key=TOKEN`. One less thing to know about because difference between ?key and ?token confused Tanja previously.