improved category documentation