add additional comments to docs