write some useful documentation