--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.categories.md	Tue Feb 26 20:41:00 2019 +0100
@@ -0,0 +1,31 @@
+vanilla package categories
+==========================
+
+The vanilla source tree split packages into appropriate categories for a better
+hierarchy.
+
+The categories are defined as following:
+
+- audio: everything related to audio from music player to editors
+- core: packages that are usually installed in a minimal system
+- desktop: miscellaneous desktop applications
+- dev: development, compilers and debuggers
+- editors: text file editors
+- emulators: game or machine emulators
+- games: games and toys
+- haskell: haskell packages and interpreters
+- kde: the plasma desktop
+- lib: packages with only libraries
+- mate: the mate desktop
+- misc: miscellaneous packages
+- network: network tools and applications
+- office: office suites and PIM
+- perl: perl packages and interpreters
+- python: python packages and interpreters
+- ruby: ruby packages and interpreters
+- system: system administration and tools
+- tcl: tcl packages and interpreters
+- video: video manipulation
+- wm: window managers
+- xfce: the XFCE desktop
+- xorg: the X distribution