Rewrite all documentation

[ecdye]

As has been mentioned many times, the openHABian documentation is poorly
written and often comes across in the wrong way. This is an attempt to
start fresh.

The goal is to keep the documentation clear, simple, and easy to follow.
All features should be fully documented and clear. Additionally the
expectations for what is supported should be clear, without making the
wrong impression on the end user, being overly wordy, or harsh.

Basically, make the documentation as great as the rest of openHABian.

[mstormi]

I believe you already recently 'softened' the HW requirements part and this https://github.com/openhab/openhabian/blob/main/docs/openhabian.md#3264-bit-support

What got lost along that way was that users should not be running 64 bit OS or java ob machines with 1GB.
Please prominently re-add a warning not to do that.

[ecdye]

@openhab/webui-maintainers Can you help me figure out how to make the sidebar have a dropdown to access a few subdocs like openHABian specific troubleshooting or more detailed feature guides?

[florian-h05]

The sidebar structure is defined in the docs repo:
https://github.com/openhab/openhab-docs/blob/main/.vuepress/docs-sidebar.js

BTW, rather ping the doc maintainers instead of us UI maintainers.

Merry Christmas to you 🎄

[ecdye]

The sidebar structure is defined in the docs repo:

https://github.com/openhab/openhab-docs/blob/main/.vuepress/docs-sidebar.js

Awesome, thanks!

BTW, rather ping the doc maintainers instead of us UI maintainers.

Whoops, I'm sorry, I thought I even double checked, but I guess I wasn't looking close enough.

Merry Christmas to you 🎄

Merry Christmas!

[stefan-hoehn]

Can you help me figure out how to make the sidebar

Did you manage to create it or do you still need help? (I saw openhab/openhab-docs#2434)

[ecdye]

Did you manage to create it or do you still need help? (I saw openhab/openhab-docs#2434)

I think that I got it, I just need to finish making all the changes here first.