more documentation and categorization