add a documentation note and build docs by default on Darwin, closes #2252