major doc updates