improve category documentation