update documentation to show usage with StateField

@jonathanslenders and @jgeskens could you review?