Background / issue
The OH documentation for the Smartthings binding contains a broken link to the addons github repo. I am the original developer of that binding and fixed this issue once but it is broken again. Is there a better solution than including a link to the openhab-addons repo?
The Smartthings binding documentation is at: https://www.openhab.org/addons/bindings/smartthings/ and that link works fine.
That page points to a file that is in the doc directory https://www.openhab.org/addons/bindings/smartthings/doc/SmartthingsInstallation.html and that link works fine. It appears that when the documentation website is built the contents of the bindings doc directory is copied.
That page contains the following link to the openhab-addons github repo: https://github.com/openhab/openhab2-addons/tree/master/addons/binding/org.openhab.binding.smartthings/contrib and this link is broken. It seems that referencing the github repo in the documentation is brittle.
That contrib directory contains files that the user needs to deploy to the Smartthings hub.
Is there a better way for me to reference the contents of the contrib directory in the documentation? Or, would it make sense to have the contrib directory copied to the documentation repo.
I could also move the contents of the contrib directory to the doc directory.
If this is better raised as an issue in a repro please let me know where it should go.