doc updated

fixes #257