documentation updated for v1.2