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.
Merge pull request #31 from ktdreyer/doc-documentation-jobs

doc: add notes about "documentation" jobs