Update the docs: a text about the records' format

Please feel free to improve. This add some (much needed, I think) text on how the records are formatted.