core: Add a comment header about the format

This should probably be a design document or something, but this is
useful for now.