more docs

some more docs - nik should do an h5 style check