Refactor metadata to ease writing custom reader
Add metadata documentation
Merge pull request #317 from romainneutron/metadata-docs

Add metadata docs, ease the process of writing custom readers