add more information to the doc and fix headers