I’ve started adding documentation to dokk. These projects use Sphinx so the building process is fairly easy: I install the dependencies and run
sphinx-build for each release tag. What I don’t like about this process is that I’m installing all the dependencies together, system-wide. Some dependencies (or custom Sphinx extensions) are specific to single projects, and some builds require specific versions.
What I’d like to do is set up a constrained environment with all the dependencies where I can build the documentation. One environment for each project, such that the dependencies are not shared system-wide.
I’ve never used Docker or Podman before (beyond simple testing) but what I’m wondering is whether they can do this for me, and if I should use them. Or maybe there is a simpler solution which doesn’t involve using them?
PS: I’m developing dokk as it’s useful to me, but if there are other people out there interested in the database I’d love to develop the project in a direction that is useful to others. Just let me know!