format 2 documentation: improvements due to internal review (#440)