This is the first page with an intro.
Here should go an introduction, notes about using pkg-config, etc
Coming soon, based on https://docs.google.com/document/d/1PrzhK7j3ljgAeYVgbQtdc7OHdMhjkn5f143X...
Categorypages should hold category introduction, stuff that you should know about the category, etc.
e.g. Pantheon Shell category will say that it's DE-independent shell, but can have some distro or DE compatibility issues due to the dependency on KDE/Ayatana indicators in Wingpanel.
After that it should have an architecture overview and integration advice; e.g. session manager launches Cerbere, and Cerbere launches everything else. Cerbere is optional and can be replaced with a decent session manager.
Application-specific info should go to the page of that app, not to this page.