moved descriptive things to concepts page
using the api reference only for explaining the resources
added a sub navigation
adjusted info boxes to be clearer