#+CATEGORY distributed linearly through the org file (which is rather difficult to maintain in the tree structure), while the CATEGORY property will be applied to the subtree.
I personally use the #+CATEGORY declaration at the beginning of each file (to make sure all entries in the file have the category displayed on the agenda), and then configure the subtrees using the properties.
The reference manual has the same argument.
source share