documentation: Migrate SECTION blocks to class annotations

gtk-doc style `SECTION` block are apparently deprecated and
modern gi-docgen annotations are preferred instead.

Migrate the existing `SECTION` blocks to class annotations,
which requires moving some documentation bits around to
avoid conflicts.
15 jobs for !2247 with wip/andyholmes/fix-doc-sections in 35 minutes and 42 seconds (queued for 5 seconds)
latest merge request