Padrino core cleanup

This is the first part of a bigger commit where I'm going through the main parts of the padrino-core part. It includes several documentation fixes as well as smaller code improvements, extracted methods, and better names for certain variables.