adding arbitrary initial value with tests
updating docs