Add Nix package for PyQGIS API Documentation builder

[imincik]

No description provided.

[nyalldawson]

Can you help me understand what the use case is here? Currently all the documentation is built using github workflows, so there's really no need for this to be packaged for use elsewhere.

[timlinux]

Hi @nyalldawson

We are in the process of deploying new infrastructure with NixOS used for provisioning all the servers (including API docs and general documentation). Having this patch applied is important to us because the documentation needs to be built as a package and then deployed in order to be consistent with the methodology we are using for server deployments. All the packages will be discrete, repeatable deployments stored in cachix which is a cache platform for Nix packages.

There may be more nix related patches coming, would be grateful if we can incorporate this work. If you want more details we would be happy to hop into a call with you to explain a bit better the process we are following. @imincik is a seasoned and well respected Nix contributor, leading the effort to make geospatial tools available on Nix (including packaging QGIS on Nix) and has been contracted by the PSC (as well as contributing his own time as a volunteer) to help with our next gen infrastructure roll out that @Xpirix and I have been working on.

Regards

Tim

[nyalldawson]

@timlinux
Does that mean the plan is to remove the publishing workflows from this repository too? How often will the new process run after a commit is merged here? Will that just be on a fixed frequency regardless of when changes are made here?

In regards to this PR -- is there any way to move these files into a subfolder? I really dislike having packaging related files cluttering up the root folder of a repository.

[nyalldawson]

This looks odd to me -- why are we using a fork here? And will this always pin the "master" docs to some old commit?