docs: add discussion on file format