Document egg format

Initial attempt at documenting our poorly-specified metadata.

@sjagoe this is your punishment PR :)