add docs and fix some doc blocks in manifest files