Move documentation into src and make docs processing a single source of truth

.github/workflows/fetch_docs_openhabian.yml

@@ -13,7 +13,7 @@ jobs:
     with:
       base_source_repository: openhabian
       base_source_ref: ${{ github.event.client_payload.ref }}
-      base_folder: installation
+      base_folder: src/installation
       doc_base_name: openhabian
       has_images: true
       is_self_contained: false

.rubocop.yml

@@ -0,0 +1,37 @@
+AllCops:
+  TargetRubyVersion: 3.3
+  NewCops: enable
+
+Style/GlobalVars:
+  Enabled: false
+
+Layout/LineLength:
+  Enabled: false
+
+Naming/FileName:
+  Enabled: false
+
+# Copied from https://github.com/instructure/rubocop-inst/blob/main/rubocop.yml
+Metrics:
+  Enabled: false
+
+Style/Alias:
+  EnforcedStyle: prefer_alias_method # https://github.com/rubocop/ruby-style-guide/issues/821
+Style/EmptyElse:
+  EnforcedStyle: empty # explicit nil indicates programmer intent
+Style/FormatStringToken:
+  EnforcedStyle: template
+Style/HashSyntax:
+  EnforcedStyle: ruby19_no_mixed_keys
+Style/PercentQLiterals:
+  EnforcedStyle: upper_case_q
+Style/PerlBackrefs:
+  Enabled: false # Regexp.last_match(1) is far worse than $1
+Style/RescueStandardError:
+  EnforcedStyle: implicit
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+Style/TernaryParentheses:
+  EnforcedStyle: require_parentheses_when_complex

.ruby-version

@@ -1 +1 @@
-3.3.2
+3.3.11

README.md

@@ -73,7 +73,7 @@ It is possible to build a preview version of the documentation on your local mac
 The following software is required:
 
 - [`NodeJS = 16.20.1`](https://nodejs.org/en)
-- [`Ruby >= 3.3.2`](https://www.ruby-lang.org/en/)
+- [`Ruby >= 3.3.11`](https://www.ruby-lang.org/en/)
 
 We recommend to use [Node Version Manager](https://github.com/nvm-sh/nvm) as well as [Ruby Version Manager](https://rvm.io/) to easily allow using multiple versions of NodeJS and Ruby for multiple projects.
 If you don't do that, you can simply start by only installing the above mentioned versions.
@@ -89,7 +89,7 @@ If `nvm` and/or `rvm` complain about the required versions not being installed,
 
 ```shell script
 nvm install 16.20.1
-rvm install ruby-3.3.2
+rvm install ruby-3.3.11
 ```
 
 Next, you can build & serve the documentation preview: