doc: add notes about "documentation" jobs

Add a bit of documentation regarding "documentation" jobs in Jenkins. This records our lessons learned during Andrew's work to create the "teuthology-docs-build" job configuration and get that particular one running. (See #30)