Fix hdf5 build notes

Add a missing `--mpi` flag to the build line for h5py.

Also, mess with the formatting a little bit and add a comment about possibly using the master version of h5py.