adding minor comments in lin ewith the docs