towards 2.0 and beyond
doc update for 2.0