add comments to docs