added some more docs and better path resolving
same improved path resolving
same improved path resolving