Yes this is a huge problem. I am not able to fully understand how to properly use these parameters nor am I able to infer what they do. Since creating two pathfinding modules, it has been difficult for me since I am at loss as to what the parameters do (although I have a little understanding from making guesses and tests). I definitely agree that more documentation should be added as the developer hub article provides little information.
First thing I would want to be added is an explanation for what “agent” means. I assume it means the rig, albeit I’m not certain.