Use `poetry` to pin docs dependencies

[rmorshea]

Current Situation

Dependencies in the container running the docs are not pinned. This can cause issues with stability.

Proposed Actions

Use poetry to create a reproducible docs environment in docs/pyproject.toml.

[ZEUS-03]

can you please elaborate the issue?

[Archmonger]

The package versions in this file need to be pinned, so that when the docs are released we won't run into unexpected build failures.

[rmorshea]

I'm realizing that a better solution to this problem would be to have a lockfile. Using pip freeze has a lot of problems. Unfortunately there aren't any standards around lock files (and there won't be for some time). The most popular solution to this problem is Poetry. The plan then would involve setting up a docs/pyproject.toml file and treating the docs as a proper "application".

Apologies @ZEUS-03, with this change of plans, I'd say this isn't really a "good first issue" anymore.

[ZEUS-03]

@rmorshea learned a lot! Thanks for the opportunity.

[rmorshea]

BTW @ZEUS-03, if you're interested in making other contributions I make myself available for office hours twice a week. If those times don't work, start a discussion and we can find a time.

[ZEUS-03]

yeah! sure.