remove some unsupported markup
remove some unsupported markup

Sections and verbatim text are not supported by godoc comments which
made the resulting page on pkg.go.dev less readable.

Fixes: #79

go-logr/logr,go-logr/logr