BUG: use the "join" string in Appender decorator

The docstring for Appender decorator says that "join" parameter is used to join the docstring and addendum.  This commit brings the code in line with the documentation.
DOC: add guidelines for building the docs