minor publishing docs

fixes #1841