docs revised