its default "/var/lib/xwiki/data/"

That's not really the default, it's just what is configured in the Debian package (and the Docker image followed the same naming). But yes, it would probably make sense to make the example value be in sync with environment.permanentDirectory example value, doing it.