all: create a special annotation to indicate that a function panics #44056
They should all be labeled as potentially panicing.
The rationale is that Go encourages you to do things concurrently in separate goroutines.
This is very dangerous because it's easy to forget that a function may panic. Labelling it as such is the least we can do, before it brings down the entire server.
One nice property of Go's doc comments is that they are not schematised, and a nice property of godoc & Co. is that the presentation is clutter free. A panic should be simply mentioned in the text as a sentence, just like anything else noteworthy should be mentioned in the text.