setPathVars should be better documented

[cobreen]

Currently, there are no explanations of where and how it can be used.

[mesqueeb]

@cobreen thanks for the issue. We greatly welcome PRs even go the docs : ) more than welcome help us with the documentation.