Just for the record, making simple updates to the docs really doesn’t take much interacting with GitHub at all. You can do it all through the Browser, including editing the files. [Wiki] How to contribute to the openHAB Documentation and How to file an Issue both provide the steps as well as a ton of background that you probably don’t need. The tl;dr is:
- Open the page you want to modify in the docs.
- Scroll to the bottom of the page and click on “Edit this page on GitHub”
- Make your changes to the file.
- Fill out the “Propose Changes” at the bottom explaining what you changed and why.
- Click on the new “Create PR” button
That’s it. No need to clone or fork or mess with any of that complications. It’ll all be done for you. You don’t even need to install git on your machine. I’ve made updates to the docs from my phone in this way.
We used to have a wiki based docs site. Frankly, it didn’t really work out all that well. Average users were as reluctant to contribute to the wiki as they were to contribute to the main docs. And wikis do not really easily support synchronizing the docs to the releases.
As you can see above, it’s even easier to update OH’s pages. You don’t need to navigate to find the page or anything like that. You don’t need to move into Edit mode, etc.