consider new theme and GHA for versioned docs

[jGaboardi]

Consider implementing the PyData Theme from sphinx.

• pydata-sphinx-theme

Also check out PyAnsys

• https://actions.docs.ansys.com/version/stable/doc-actions/index.html

[martinfleis]

I suggest moving this under pysal/pysal and have a discussion on switching the theme across the packages. And there may be better options than pydata-sphinx-theme, like book (used in xvec) or furo (used by xyzservices). I'd be eventually willing to switch momepy to the same one :).

[jGaboardi]

I am very +1 on both suggestions. Just put the issue here so I wouldn't forget.

Think we should migrate to an Issue or Discussion over in pysal/pysal?

[martinfleis]

Yeah. Since it is actionable and can be closed by a PR, an issue?

[jGaboardi]

xrefs:

• Consider using SCVersioning for docs #1216
• Move to single directory and auto generate/publish docs #1246
• weird cascading references in docs spopt#303
• etc.

[jGaboardi]

Another possibility: diátaxis

[martinfleis]

Here are those 3 themes mentioned above used on momepy's documentation.

• pydata (also the actual one)
• book
• furo

Each can be also customised a bit so it may look slightly better/more fitting than on these examples where I just replaced the theme in the conf.py.

[jGaboardi]

It's seems that none of those 3 momepy examples allow for switching the previous docs version. Is that something that needs to be turned on or probably I am simply missing something.

[jGaboardi]

Also, looks like we need to update the copyright year over in momepy. I'll open ticket for that.

[martinfleis]

It's seems that none of those 3 momepy examples allow for switching the previous docs version

I haven't done anything on that front, just wanted to showcase themes. It was not supposed to work, though pydata theme has a machinery for that.