wrapped up initial pmd/doc pass