Draft: Docs: Remove some gtk-doc sigils

These are unnecessary in gi-docgen, the docs should prefer using markdown whenever possible.

Still left are the enum/flag constants, those may want to be replaced with a link: gi-docgen#121 (closed)

Related to glib#2899