documentatin updates
document deprecations, refactor finalize body a bit