readthedocs not updated?

[jfkcooper]

I don't know how readthedocs updates, but when I look at https://www.reflectometry.org/orsopy/fileio_usage.html I get the old version of the file (not what has been updated here). I don't have time right now to look into it, but am writing this as a reminder

[andyfaff]

The workflow only runs on a release.

[jfkcooper]

Ahh that makes sense! Any concerns if I add a hook to the workflow to run it manually and update the docs?

[andyfaff]

See #122 for background on this.

The docs are only supposed to be built on release, so the code matches the doc.

(I prefer readthedocs approach where you get both)

[aglavic]

It's possible to add this as a workflow-displatch runner to be able to do doc fixes between releases.

[jfkcooper]

Having read #122 I'm still not quite sure why it isn't pulling in the current version of 'fileio_usage.rst'.

Am I right in thinking that we now have two (potentially different) documentation pages - https://www.reflectometry.org/orsopy/ and https://orsopy.readthedocs.io/en/latest/ ?

I can see the desire to keep the code and documentation in agreement, but then we should be able to make documentation only pushes and have them reflected to users. Maybe I'm just not following the expected workflow though, so please let me know!