added some important documentation