Docs: Improve documentation for category abilities functions

[galatanovidiu]

This is something we could extend a bit in a follow-up in the document describing the available functions for category abilities.

Originally posted by @gziolo in #102 (comment)

[jonathanbossenger]

#117 includes a fix for this