doc reorg
parth
parta
rm warnings