LANG-701 Made changes suggested in JIRA comment. Added extra Javadoc with examples, and handle nulls in the same way as 'join(Iterable, String)'