Improvements to the beginner tutorial (openhab#1356)

* Improvements to the beginner tutorial. Signed-off-by: Jerome Luckenbach <[email protected]> * Move tutorial sidebar (nearly) to the top. Signed-off-by: Jerome Luckenbach <[email protected]>
xkiller0 · Dec 21, 2020 · a784207 · a784207
1 parent 1d6fbb9
commit a784207
Show file tree

Hide file tree

Showing 7 changed files with 24 additions and 27 deletions.
diff --git a/.vuepress/docs-sidebar.js b/.vuepress/docs-sidebar.js
@@ -6,6 +6,26 @@ module.exports = [
       ''
     ]
   },
+  {
+    title: 'Beginner Tutorial',
+    collapsable: false,
+    children: [
+      ['tutorial/', 'Tutorial Overview'],
+      'tutorial/first_steps',
+      'tutorial/things_simple',
+      'tutorial/things_intermediate',
+      'tutorial/things_advanced',
+      'tutorial/model',
+      'tutorial/persistence',
+      /*'tutorial/pages_intro',
+      'tutorial/pages_widgets',
+      'tutorial/pages_types',
+      'tutorial/rules_simple',
+      'tutorial/rules_intermediate',
+      'tutorial/cloud',
+      'tutorial/example'*/
+    ]
+  },
   {
     title: 'Concepts',
     collapsable: false,
@@ -35,26 +55,6 @@ module.exports = [
       ['installation/security', 'Security']
     ]
   },
-  {
-    title: 'Beginner Tutorial',
-    collapsable: false,
-    children: [
-      ['tutorial/', 'Tutorial Overview'],
-      'tutorial/first_steps',
-      'tutorial/things_simple',
-      'tutorial/things_intermediate',
-      'tutorial/things_advanced',
-      'tutorial/model',
-      'tutorial/persistence',
-      /*'tutorial/pages_intro',
-      'tutorial/pages_widgets',
-      'tutorial/pages_types',
-      'tutorial/rules_simple',
-      'tutorial/rules_intermediate',
-      'tutorial/cloud',
-      'tutorial/example'*/
-    ]
-  },
   {
     title: 'Configuration Guide',
     collapsable: false,
@@ -83,7 +83,6 @@ module.exports = [
       ['configuration/ui/habot/', 'HABot'],
       'configuration/habpanel',
       ['configuration/ui/basic/', 'Basic UI'],
-      // 'configuration/rules-ng',
       ['apps/android', 'Android App'],
       'apps/ios',
       'apps/windows',

diff --git a/tutorials/getting_started/first_steps.md b/tutorials/getting_started/first_steps.md
@@ -64,18 +64,16 @@ Note that by default, using openHAB doesn't require you to sign in.
 Only administrative operations require a user with an administrator role to be logged in.
 
 ## Initial Settings
-Click on Settings.
+
+Most of the needed settings have already been accomplished, when you have followed the wizard.
+Fro further configuration (e.g. the measurement system) click on Settings.
 
 ![](images/initial_settings.png)
 
 Click on Regional Settings under System Services.
 
 ![](images/regional_settings.png)
 
-Configure the local language, region and time zone.
-You can also specify the exact location (latitude, longitude, altitude) of your home, which some add-ons can use to preset their configuration.
-For instance, the Astro binding will use the location to determine the time of astrological events like sunrise and sunset in your area.
-
 If you're not using the metric system, click "Show advanced" and change the measurement system.
 
 ![](images/units_settings.png)

diff --git a/tutorials/getting_started/images/wizard_addons.png b/tutorials/getting_started/images/wizard_addons.png
diff --git a/tutorials/getting_started/images/wizard_geo.png b/tutorials/getting_started/images/wizard_geo.png
diff --git a/tutorials/getting_started/images/wizard_location.png b/tutorials/getting_started/images/wizard_location.png
diff --git a/tutorials/getting_started/images/wizard_welcome.png b/tutorials/getting_started/images/wizard_welcome.png
diff --git a/tutorials/getting_started/things_simple.md b/tutorials/getting_started/things_simple.md
@@ -7,7 +7,7 @@ title:  Adding Things - Simple
 
 # Adding Things - Simple
 
-As covered in the [concepts section]({{base}}/../../../concepts/index.html) of the openHAB Docs, a binding is an add-on to openHAB that understands how to communicate with a specific home automation technology or API.
+As covered in the [concepts section]({{base}}/docs/concepts/index.html) of the openHAB Docs, a binding is an add-on to openHAB that understands how to communicate with a specific home automation technology or API.
 A Thing represents a single device in openHAB.
 Each sensor (information provided by the device) or actuator (control on the device that causes it to do something) is represented by a Channel on the Thing.
 Things are the connection between openHAB and your external device or API using the binding.