rejig header slightly
make official documentation