format 2 documentation: step 1 (#440)