Merge pull request #1051 from FlowFuse/migration-guide-updates

Docs: Migration Guide updates

Author: joepavitt

docs/user/migration.md

@@ -11,6 +11,7 @@ description: Easily migrate from Dashboard 1.0 to 2.0 with this comprehensive gu
     import uiDropdown from './migration/ui_dropdown.json'
     import uiForm from './migration/ui_form.json'
     import uiGauge from './migration/ui_gauge.json'
+    import uiLink from './migration/ui_link.json'
     import uiSlider from './migration/ui_slider.json'
     import uiSwitch from './migration/ui_switch.json'
     import uiTemplate from './migration/ui_template.json'
@@ -25,6 +26,7 @@ description: Easily migrate from Dashboard 1.0 to 2.0 with this comprehensive gu
         'ui_dropdown': uiDropdown,
         'ui_form': uiForm,
         'ui_gauge': uiGauge,
+        'ui_link': uiLink,
         'ui_slider': uiSlider,
         'ui_switch': uiSwitch,
         'ui_template': uiTemplate,
@@ -59,7 +61,9 @@ Dashboard 2.0 will work alongside Dashboard 1.0, so you can start building your
 
 ### Migration Script
 
-It is worth noting that we do have [plans](https://github.com/FlowFuse/node-red-dashboard/issues/261) to write some migrations scripts, that will take in a `flow.json` containing Dashboard 1.0 nodes, and output a `flow.json` containing Dashboard 2.0 nodes. However, this is not yet available, and will unlikely conduct a perfect 100% migration. Any thoughts, opinions and feedback on this idea are very welcome on the [GitHub issue](https://github.com/FlowFuse/node-red-dashboard/issues/261).
+We have a [Migration Service](https://flowfuse.com/product/dashboard/#migration-service) available to help you get started on moving your existing Dashboard 1.0 to Dashboard 2.0.
+
+Whilst it will not migrate _everything_, it will give you a significant head start, and automate the majority of it for you. Anything that cannot be automatically migrated, are left in the flow, but disabled, so that they're flagged as requiring manual intervention.
 
 ## Dashboard 1.0 Nodes
 
@@ -179,8 +183,6 @@ There has also been a [request](https://github.com/FlowFuse/node-red-dashboard/i
 
 <MigrationWidgetProfile :profile="widgets['ui_link']" />
 
-You can track progress of this development effort here: [Issue #387](https://github.com/FlowFuse/node-red-dashboard/issues/387)
-
 ### `ui_numeric`
 
 Whilst this widget has no explicitly been transferred into Dashboard 2.0, the functionality is still available in the `ui-text-input` widget, where you can select the _"type"_ to be _"number"_.

docs/user/migration/ui_button.json

@@ -1,6 +1,5 @@
 {
     "node": "ui_button",
-    "description": "Button",
     "properties": [
         {
             "property": "name",
@@ -24,8 +23,8 @@
         },
         {
             "property": "icon",
-            "changes": -1,
-            "notes": "<a href='https://github.com/FlowFuse/node-red-dashboard/issues/322' target='_blank'>Issue #322</a>"
+            "changes": null,
+            "notes": null
         },
         {
             "property": "tooltip",
@@ -54,8 +53,8 @@
         },
         {
             "property": "emulate click",
-            "changes": -1,
-            "notes": "<a href='https://github.com/FlowFuse/node-red-dashboard/issues/209' target='_blank'>Issue #209</a>"
+            "changes": null,
+            "notes": null
         },
         {
             "property": "class",
@@ -66,23 +65,23 @@
     "msgs": [
         {
             "property": "label",
-            "changes": -1,
-            "notes": "<a href='https://github.com/FlowFuse/node-red-dashboard/issues/376' target='_blank'>Issue #376</a>"
+            "changes": null,
+            "notes": null
         },
         {
             "property": "icon",
-            "changes": -1,
-            "notes": "<a href='https://github.com/FlowFuse/node-red-dashboard/issues/376' target='_blank'>Issue #376</a>"
+            "changes": null,
+            "notes": null
         },
         {
             "property": "enabled/disabled",
-            "changes": -1,
-            "notes": "<a href='https://github.com/FlowFuse/node-red-dashboard/issues/352' target='_blank'>Issue #352</a>"
+            "changes": null,
+            "notes": null
         },
         {
             "property": "visible/hidden",
-            "changes": -1,
-            "notes": "<a href='https://github.com/FlowFuse/node-red-dashboard/issues/377' target='_blank'>Issue #377</a>"
+            "changes": null,
+            "notes": null
         }
     ]
 }

docs/user/migration/ui_chart.json

@@ -1,6 +1,5 @@
 {
     "node": "ui_chart",
-    "description": "Chart stuff",
     "properties": [
         {
             "property": "name",
@@ -49,8 +48,8 @@
         },
         {
             "property": "x-axis label",
-            "changes": -1,
-            "notes": "<a href='https://github.com/FlowFuse/node-red-dashboard/issues/382' target='_blank'>Issue #382</a>"
+            "changes": null,
+            "notes": null
         },
         {
             "property": "y-axis min/max",

docs/user/migration/ui_dropdown.json

@@ -1,6 +1,5 @@
 {
     "node": "ui_dropdown",
-    "description": "Dropdown",
     "properties": [
         {
             "property": "name",
@@ -29,8 +28,8 @@
         },
         {
             "property": "placeholder",
-            "changes": -1,
-            "notes": "<a href='https://github.com/FlowFuse/node-red-dashboard/issues/386' target='_blank'>Issue #386</a>"
+            "changes": "merged",
+            "notes": "Combined with 'label' property in new design"
         },
         {
             "property": "options",

docs/user/migration/ui_form.json

@@ -1,6 +1,5 @@
 {
     "node": "ui_form",
-    "description": "Form stuff",
     "properties": [
         {
             "property": "name",
@@ -62,13 +61,13 @@
     "msgs": [
         {
             "property": "msg.properties",
-            "changes": -1,
-            "notes": "<a target='_blank' href='https://github.com/FlowFuse/node-red-dashboard/issues/287'>Issue #287</a>"
+            "changes": "changed",
+            "notes": "Now <code>msg.ui_update.options</code>."
         },
         {
             "property": "msg.payload",
-            "changes": -1,
-            "notes": "<a target='_blank' href='https://github.com/FlowFuse/node-red-dashboard/issues/363'>Issue #363</a>"
+            "changes": null,
+            "notes": null
         }
     ]
 }

docs/user/migration/ui_link.json

@@ -0,0 +1,20 @@
+{
+    "node": "ui_button",
+    "properties": [
+        {
+            "property": "name",
+            "changes": null,
+            "notes": null
+        },
+        {
+            "property": "path",
+            "changes": null,
+            "notes": null
+        },
+        {
+            "property": "icon",
+            "changes": null,
+            "notes": null
+        }
+    ]
+}

docs/user/migration/ui_slider.json

@@ -1,6 +1,5 @@
 {
     "node": "ui_slider",
-    "description": "Slider stuff",
     "properties": [
         {
             "property": "name",