search

pysal / submodule_template

This provides a template for submodules to use in the PySAL project
BSD 3-Clause "New" or "Revised" License
2 stars 10 forks source link

automated docs publishing #33

Closed knaaptime closed 1 year ago

knaaptime commented 3 years ago

not sure the best place to put this, but the final automation step, imo, is to have the docs built automatically from source. That should be doable with this action so ill carve out some time to try it out

knaaptime commented 1 year ago

the work here has been done for a couple years. Lets resolve this by adding an example yaml like https://github.com/pysal/spopt/blob/main/.github/workflows/build_docs.yml

knaaptime commented 1 year ago

xref https://github.com/pysal/giddy/issues/179

martinfleis commented 1 year ago

Shall we also try to figure out how to keep the version chooser? Having old releases, main and latest is quite useful.

knaaptime commented 1 year ago

+1

I'd also be interested in exploring an overhaul with myst, but need a compelling motivation

martinfleis commented 1 year ago

We use across some projects and any new one is myst default. It is so much better over rst and can run along is, so you can have some files as rst and other as md. So the gradual transformation is easy.