BREAKING CHANGE! This change provides for future file format changes, but also breaks backwards compatibility. Also describe the file format in design_document