more documentation for operation constructor arguments