lets document join()
- start building out very comprehensive docstrings for core functions
case
seealsos in the tutorial
tweak text