So, do you think anything can be done to make when assembling strings less confusing / fix the inconsistency between the syntax of of os.path.join and str.join ?
How about improving the documentation. Providing additional examples might be a good starting point.
That could make a good blog post. In fact, there might already be one out there. I've not looked.