proposal for refined documentation

This is a proposal to refine the _ documentation by:
1) Adding subcategories, eg, Collections/Filters.
2) Adding types for args & return values.