documentation revisited