When using gi-docgen (after bug #239016), it will use the first paragraph
of a documentation comment as the “brief” description an entity (function,
struct, etc.). Many are already fine, but gtk-doc (which we used before)
did not work in the same way, which means a number of documentation comments
are missing a brief description, or the existing one is too long and usually
should be taken as long description instead.

It would be good to find the items with missing brief descriptions and add
them. One idea to avoid reading all the documentation comments manually
would be to make a script that parses the .gir XML used as input for gi-docgen
which detects items with only one paragraph, or more than one paragraph but
the first one is too long (more than 80-90 characters, or a similar check.)