Support tagging symbols
We want to be able to group API depending on specific uses, e.g.
- API useful for application developers
- API useful for toolkit developers
- API useful for people deriving a class
One option would be to introduce an attribute, like org.gtk.Tag
, taking a comma-separated list of well-known tags; gi-docgen would then take the tags and use them in various contexts:
- searching
- populating/sorting indices
- populating the "inherited from" sections
- adding a note to the symbol page
Requirements
-
collect a list of use cases in GTK (and possibly other libraries, like libadwaita) -
turn use cases into tags -
define a human-readable name/description for each tag