much better template-documentation; misc typos fixed