finalized v1 of docs