Split documentation for various routes and ACL configuration/caching

[Ocramius]

Configuration is a mess. We should just split it and remove any unnecessary code that the user wouldn't need to read or is too confusing.

[matuszeman]

I think we should start wiki pages instead.... and README.md should include basic setup with reference to online doc/wiki for more details.

[Ocramius]

A bit against the wiki pages as they're not cloned with the repository itself... We could simply spread README.md files across the directories... That makes things easiers for implementors/consumers that find the module in their project and don't know where it comes from :P

[matuszeman]

I've tried that with KapitchiIdentity "readme" and it works... ;) agree.