How about adding a simple example of how to convert to and from int8? I would also explicitly say what extra attributes are added to the `.h5` file from which one can see what type of `.raw` file one is dealing with. This is probably best done here, perhaps simply by giving the command that shows them, e.g.,
```
Examples
--------
>>> from digitize import convert_dtype
>>> digitize([...], outdir='...')
[any output]
>>> import h5py
>>> i1header = h5py.File('...')
>>> [some construct that shows the new headers]
>>> convert_dtype([...i1files...], outdir='...', direction='i2f')
>>> f4header = h5py.File(...)
>>> [some construct that shows the headers that are different from the original]

file may be run from the command line as
python digitize -h  # for help
python digitize <same example as from interpreter above>
```

Furthermore, I'd use as main title
```
Routines to convert raw LOFAR data between 4-byte floats and 1-byte integers
```