format 2 documentation: step 2 (#440)