Build docs with docs deps and make

[mikemckiernan]

Description

Build the docs for PRs, merges to develop, and tags.

Related Issue(s)

Checklist

• I've read the CONTRIBUTING guidelines.
• I've updated the documentation if applicable.
• I've added tests if applicable.
• @mentions of the person or team responsible for reviewing proposed changes.

[mikemckiernan]

I can't explain why the PR preview job isn't running and isn't visible. I'm OK with troubleshooting that after merging this one or #954.

The goal of this PR is so the engineers contributing to the project can choose what they feel is the best developer experience. I have a history of favoring containers for building docs, but if the dev experience is to use poetry and a venv, I'm game.

[Pouyanpi]

This is GREAT! 🥇
Thank you @mikemckiernan , let's merge it and see how it goest 👍🏻

[Pouyanpi]

for later, maybe just trigger it when there is a change to docs dir, .md or rst file?

        paths:
            - 'docs/**'
            - '**/*.md'
            - '**/*.rst'

[mikemckiernan]

This is worth doing now, IMO.