fixing some structuring issues in the HOWTO and adding more content