From 48efab796de11141555c23b2910e438412cdd4e1 Mon Sep 17 00:00:00 2001
From: Julian Molina <julian@nomadinception.com>
Date: Mon, 29 Mar 2021 15:13:21 +0200
Subject: [PATCH] This is my contribution to Superalgos

---
 Projects/Superalgos/Icons/Thumbs.db           | Bin 5921280 -> 5921280 bytes
 ...s-.32-tutorial-step-before-you-switch.json |  35 ++++++++++++++
 ...lgos-.34-tutorial-step-double-trouble.json |  30 ++++++++++++
 ....36-tutorial-step-lets-switch-already.json |  43 ++++++++++++++++++
 ...-tutorial-step-congrats-and-thank-you.json |   4 +-
 ...-7.2-tutorial-step-switching-branches.json |   4 +-
 ...-tutorial-step-now-the-current-branch.json |  10 ++--
 ...ralgos-7.4-tutorial-step-welcome-back.json |  25 ++++++++++
 ...lgos-7.5-tutorial-step-update-the-app.json |  33 ++++++++++++++
 9 files changed, 175 insertions(+), 9 deletions(-)
 create mode 100644 Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.32-tutorial-step-before-you-switch.json
 create mode 100644 Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.34-tutorial-step-double-trouble.json
 create mode 100644 Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.36-tutorial-step-lets-switch-already.json
 create mode 100644 Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.4-tutorial-step-welcome-back.json
 create mode 100644 Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.5-tutorial-step-update-the-app.json

diff --git a/Projects/Superalgos/Icons/Thumbs.db b/Projects/Superalgos/Icons/Thumbs.db
index f1195350ffd0f2ad868df97735aa60f137fa9e64..81066df301d8d8cae4a1a352eda58f6f8d23d9b0 100644
GIT binary patch
delta 2520
zcmZ8jYfKbZ6y8C=E6x-YC@ZckA}>LZT^4oSrHDuop$rSlF09WMgRPIm$0Z?YE86~;
zw$>QMdYe8XwGU~U7~2{zwbisNsnII4R*I=j8?~`0wbsWaT_2@AyR)%(y2+PpzH`p^
zopa{S&1^ezJ!%`^@cQW3?uLse-^lFR96f{zqYQ?B;72U)CuY8kV<?Uh0wv--gTZh|
z;6emD1i8x}W9cf2j;29}P$Nh}E@WNdvlLt^0HP=^9XGfOeW8z?9Y^umXm=`FujAQp
zw8DmCC>xG-uR)*jF^c8!>KRG+8;qQMrxcrz{1&Om@meT5iUP;P&=B)=wQSP_b%gj^
zJr=^2#mU4E$qHT`NAdEBfm`7Mo2~%YiS>e52^`^hg~=j7qD+2FzA6cM(8vuwf#Q;Q
zc~59L3OgAONB~Tt?BwM7^<kSaX#dfY6>LkS*p@Wdh?;p7f?r9JCBv7%eaGih_DWLV
zpjZdo3SB-cO0E~@0DYBDSFj}+@HoYm6d6fE$aglsI)&L&D6<>oD#@@F1TXNS3f^u6
zOrdyts@xzMTo5eb<taO#8t{duy36wlE1XJMp{ZUJdw~Ctk5TL}xjRuRZ$#NKlkAlQ
zC6f4PJrqx#rV5f_6$JWt6$K|vqc|x|epV7*1gRK)D8gPyQzc<sg!@m8y_hz5ADMY;
zg>{$#>6CR$SKpKb3luf*36xFB2z(Wu@g2Sc$_6sz4oN8Zzl(yaW&koNuF8`0CE;zT
zO4nCz&T{WS2Cn5S(ms||ryZKHEXu~R18c;5NJ!=j71owRSzE5UMa#UHOWDPlgNM<6
zeZxEQ0*A%fz?E<onUp#6>kowoxy`Fm{CmDUNjn=3eZj+gwO<luMM!Rs-^^0gu8J6V
z-F6qq%Ot@LDJS%zHw)@dht14-&E7(F8}auw!Ruk44JZPDj@>F>4lClR#e+xC5HCh>
zpjeiKKY*LbixC#$4e`Jw^BYj`xnhdX+2nAK3hOSRtb2}pocJ%aSSVgGcklrk<qatI
z%?tF2nIN)@7ovEY-MtlkuFGX_+vQqP!9w@PH9KHF#n&8i2JxRNwUW^|XC3jIkX31)
z=meC~_K8mn*d@aZ5dKLoUipN2LJ}H5JxezhjxK}an-k$4tzE$}WpE=ekkcd~9*T<i
zBFbhg2-K4Ppv|I;Zd^b|H<ma0(R5u3wk?$5Wx5Wv>AC<bStu`+gc(4d<7ZXy?u8WZ
zu8?;Uf2|8{&a_35m6{hR%v=e0k}`9Zx=u1IgxNazV#;<@1ulzQfG^PV8y2hQwexmJ
zw-8odt<KZ}0^gs))>Q+R0BQiWfTsX;l&zE9=h0qXM8ReC6qmVFG4zfQT<e0n-n<AN
zOs#7mL{avX%M^t+i<hj_)A<`Q=B1U>mO0}OChu!=C7^^mKcD_>?DBnLd`AM_w&Y;e
z(bruG>1apr(o5eSvi5fw;}+27T1QXvzCM><Q|xn@1Qc)Gv(o)u_lTD8T6K@(NJByt
z3gpEe9;unLhl0_&DP(6{Y|YWs2LF$t!>+Kq4S+_<?z-gxZSqona)SGsWKwZ05&G|I
z8X*3M`BpmWZ<?Bm()R_Q-`l^YI@0KkCR%~;26g+*8wZvWqcs_tFY>IlhPS|;@u*s-
zt)75L`pt_hWOSpaj#PN3SV{XPPx$H~Y?H@?+8%s7`IC;`Y+`&V1~fK%s0AHgvA@lF
zdGS1AL>Aya@X#96{<ZJvRgV`B5#y@4z}@nUl!U!-wm1A~Kp6ZX6%(CckmHRQ<akZU
zIqdtsz*#(t7(LUWFxN{<(dzQvp~@uNvdGhD^U@SlxwAtwT`!0RgE+|B>ZQ}s{_@uO
ziIuls)pp$N{k>81WSS>s%xfBlzKHb&4{V>{rN*E)=s<(QkoSiH42IexZKhdBJ)OS9
z`KxkK6Y@3pR-wT^Kh3MUvNcGI+2!DOpqb7@t2;kh8N1O|t)-o5?kz(r^P4xdKKDx}
zF&-;~G_hsvX-T*bNAOerkP|l45?T3$7PmQ}JsYC%`}qU^mmjrG9SeP7^&AbhzyWzg
z8RywR@P5lkjy6<=FT6;~GJK)qHIR7Z-uhF+S}U2p-W24>U0iM*`)iLzIek6T{sm^?
BS6~1D

delta 2499
zcmZWq3v5%@8TQSCo|$_?pmF0Rj*~bsF@!uE62LeiAr5nC+}t>E>?8#QMGX}R8_<(2
z(gvkW=%RMCOEdLsrQJ|pq?O9phVp07(l&0Jsz7W+c#Ns7Kp-fzD1#G?1)A-*Z`K`a
zSNf&n?|*#%<NU|Fj(nZ83*~T6%B;E-VDl9WY)?7I9(E-!`Xx;Tnkq%BWJ8j{a9c7M
z{*51VzW!h#qi#u6q}cC22)G08x}`>GAe`#dXpMxD1hgi3`~@OmgzvpIdMX*{sgyt#
zDNn%pwG@qCO9g&yR$vn;5OqM+2O=k9k%3x>`f~ilhe-6O+>RM67qTb>zU>E*8%mt8
zNDRXG8l$S?Pl*m1U26ooc6M|^&O*FW)B$ahn<aSx#$h6^aaBf9fU9ZhRmHFn4b~fk
zDuGtbQD4-X^qWM_(K#9)O-Gpvd~{xOk6eiQY0+7ul@9`~%ouMa?t}{H-VAK~F|<D+
z+5_L45j`k>gZMg;i}7+(vs{KDu8QUwb(&Bf0_x0ENqk=1l?mKsR=tX}6C<1#qiFOQ
zGs+KvK9i-kD3TwQRbo8gXR@N5av9=xL|o&g*}zLJ&9YpBIlL+AfVwS#r%AO~9`K_U
zHKb2@UQR?(q$YG35#2PJkpnctsy-PrWBeD^h<+D#SjVTxA~BlA`*Kn8fcND`eybRq
zsB97I0zTIkeNX-~Vy}oCz{hNAU%V~UTcA;IAyBVfEmjQs(JU{~bh|z9Tzp>`owm;`
z#VV0S<I{HF)AOU7<k$+BM0bsM6#?&ZM4r+wiX%~Z(E<G8g7L#-j)(()ZejGWoR8&H
ziS+`nE^a;~m!R!G671>CVs$PHhubP(@_zBy$IP>=438fz8jCQ`#vmU1OPbcOaIdWb
zdT*7epUXX1KyG5};nK*icuTmeOyjO{6er%83iT56^r+~Vz4*)#QX)Dr8eOdFW5R<X
z%|WFpp*8gMVxXrh)%XlGexM5YfhFqu@rlxPOULh#Vlg1l&SlXNITf)N#5h26T!Eb=
zIl-3icd0%WPOYubdat`smP7A#cau$#Txj<vu|td-tK*4kbapjL4ba&uA}&QLK$gEJ
zGObz>IUcWxrqt?b)6`mgDC<;fJZ)Z37xl@1opJi#qsO<_0pGeZ5GFA!_Qju4-12%A
zFZ$P*PhMjFRrTs)v5*?=uLs)iQTN4pxwRp}!aje6HksRivI^x#Fq!Ke>sF+C<b7H!
z4KIr~dP!b_SZQMTEe}V|=#Sx{gbMk})sY2pUf#W0<K2&-G@|%W9z|&a-mM1CkXDgK
zqqWUIYyA;fk^VKK_`XI)eSVdNtqr)ZK7T~N>VFa4fj{cEB#|#{_RVJ<+Hq!HXk7^%
zOCC6Ada28wPVU`msPw({^T(L^6$SCiM-JMDe&tWkBhzoQH+JRF{sFVG4%&V0LDNek
z{;(q1vDD)NfgL7C{MiyQjpiM7ytC(d-Tv9tgYF|O=}F|*<vF8U()<&Eysu`mea2ah
zLs>21zv*4L)1vV^t-$XD)Uo&k=tvuu<0`{)M%re|IW4f^KTx>M;vnDc@xJ@zyo*oF
zr2S1Bcu09>cz4#GzVpmnVZu_%gPSW9X$l9hLmUF*j|XwcYmB&J8-r0<{`UWR%C`np
z=5ZxE8Qm6~d3PqoBpBZow2)Bsy}rWNP6IRVPDQ@$L2!~wKRs()-Z1b_W+qO=-Uvb?
z*>^wvi-uE~jm*4$DPj}B8&&$8auf2R^FuRS=MuRPXW=1&*%aZ)v(|{sDGFK0wuzs;
zv$b$yH!}zGF|H#7H6;7OT)5J@_^X*QcZDF6e3mw@C?AINk>7}RJ4299ewVi8U90x&
zxB9dWgl@Jn&vh44@EF-GD?VI2l$}ggrS-45UHAJRgZXaguA6wLCZe;tZ(sTEZD|KP
zId=c%Pp&R?e5Hr#Y#;WL*?V*MZ|Hf^#?13qBI9fAuz-|axUuYyE_ab`cCvlAmc07W
z22=XkLj%lwv=q(cj?JIzYk00B!aVDi;)Kq31acX9-k%=Z=)s}89eAZad-;?4gT=$W
z%)G1;-KIKj6e-eo*t5%t{j_yrKQ+V$#eM>}by_6SwQ0xYV-D>DJ)OeN;Y<RbmQ0;E
Nd#_1{syhdB{sUq8Oz;2z

diff --git a/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.32-tutorial-step-before-you-switch.json b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.32-tutorial-step-before-you-switch.json
new file mode 100644
index 000000000..ac7ce32b5
--- /dev/null
+++ b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.32-tutorial-step-before-you-switch.json
@@ -0,0 +1,35 @@
+{
+    "tutorial": "Contribute to Superalgos!",
+    "pageNumber": "7.32",
+    "type": "Tutorial Step - Before You Switch",
+    "definition": {
+        "text": "There are a few things you should consider every time you switch branches! Let's go through a quick list bfore you proceed!",
+        "icon": {
+            "name": "bullet-warning",
+            "project": "Superalgos"
+        },
+        "updated": 1617018123415
+    },
+    "paragraphs": [
+        {
+            "style": "List",
+            "text": "It may happen that the workspaces or other data structures in the master branch are not compatible with those in the develop branch. ",
+            "updated": 1617017830521
+        },
+        {
+            "style": "List",
+            "text": "If the current workspace is incompatible with the software in the other branch, the workspace may break upon reloading the app. In such a case, you must load a Plugin Workspace of the new branch.",
+            "updated": 1617018153708
+        },
+        {
+            "style": "List",
+            "text": "Even the structure of mined data may have changed!",
+            "updated": 1617017781902
+        },
+        {
+            "style": "Important",
+            "text": "Always check the README file in the develop branch of the repository for any comments on backward compatibility. Before switching branches, it is always good to back up your work!",
+            "updated": 1617017837289
+        }
+    ]
+}
\ No newline at end of file
diff --git a/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.34-tutorial-step-double-trouble.json b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.34-tutorial-step-double-trouble.json
new file mode 100644
index 000000000..b6f7fc161
--- /dev/null
+++ b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.34-tutorial-step-double-trouble.json
@@ -0,0 +1,30 @@
+{
+    "tutorial": "Contribute to Superalgos!",
+    "pageNumber": "7.34",
+    "type": "Tutorial Step - Double Trouble?",
+    "definition": {
+        "text": "Many users choose to run the two branches from separate folders! This seems like a sensible solution for active contributors!",
+        "updated": 1617018855666,
+        "icon": {
+            "name": "clone-entity",
+            "project": "Superalgos"
+        }
+    },
+    "paragraphs": [
+        {
+            "style": "Text",
+            "text": "You may have two clones of your fork running from separate folders, one of them in the develop branch.",
+            "updated": 1617018731051
+        },
+        {
+            "style": "Note",
+            "text": "Two instances of Superalogs running from different folders are completely independent. They run distinct workspaces and output unique data.",
+            "updated": 1617018971209
+        },
+        {
+            "style": "Success",
+            "text": "Such a setup allows you to run the stable version for your production tasks, and the version in develop to contribute and test new features!",
+            "updated": 1617018806324
+        }
+    ]
+}
\ No newline at end of file
diff --git a/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.36-tutorial-step-lets-switch-already.json b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.36-tutorial-step-lets-switch-already.json
new file mode 100644
index 000000000..82b73c198
--- /dev/null
+++ b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-.36-tutorial-step-lets-switch-already.json
@@ -0,0 +1,43 @@
+{
+    "tutorial": "Contribute to Superalgos!",
+    "pageNumber": "7.36",
+    "type": "Tutorial Step - Let's Switch Already!",
+    "definition": {
+        "text": "Now that everything's clear, let's do the switch and get ready for what comes next!",
+        "icon": {
+            "name": "docs-success-style",
+            "project": "Superalgos"
+        },
+        "updated": 1617019411568
+    },
+    "paragraphs": [
+        {
+            "style": "Text",
+            "text": "This is what you need to do:",
+            "updated": 1617019437652
+        },
+        {
+            "style": "List",
+            "text": "Go back to the footer and select Develop as your Current Branch.",
+            "updated": 1617019546125
+        },
+        {
+            "style": "List",
+            "text": "You will get a page explaining what is being done. Once the process finishes, you will get another page telling you of the outcome.",
+            "updated": 1617019740630
+        },
+        {
+            "style": "List",
+            "text": "Stop / close the app (browser and console).",
+            "updated": 1617019826262
+        },
+        {
+            "style": "List",
+            "text": "Restart the app!"
+        },
+        {
+            "style": "List",
+            "text": "Find the Contribute to Superalgos Tutorial in the bottom-right corner of the workspace and select Resume in the menu!"
+        }
+    ]
+}
\ No newline at end of file
diff --git a/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-020-tutorial-step-congrats-and-thank-you.json b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-020-tutorial-step-congrats-and-thank-you.json
index c3a0cd6a5..aaca4a4c6 100644
--- a/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-020-tutorial-step-congrats-and-thank-you.json
+++ b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-020-tutorial-step-congrats-and-thank-you.json
@@ -13,8 +13,8 @@
     "paragraphs": [
         {
             "style": "Text",
-            "text": "If everything went well with your authentication, you should see the Contribution Done message!",
-            "updated": 1611595956742
+            "text": "If everything went well with your authentication, you should see the App Message - Contribution Done page!",
+            "updated": 1617023256176
         },
         {
             "style": "Callout",
diff --git a/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.2-tutorial-step-switching-branches.json b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.2-tutorial-step-switching-branches.json
index 986f2a084..2cdc0d634 100644
--- a/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.2-tutorial-step-switching-branches.json
+++ b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.2-tutorial-step-switching-branches.json
@@ -13,8 +13,8 @@
     "paragraphs": [
         {
             "style": "Text",
-            "text": "Superalgos is constantly improving. At some point, you may wish to try the software version in the develop branch. Maybe there is a new feature, or a fix for bug that hasn't got to the master branch yet...",
-            "updated": 1616760221737
+            "text": "Superalgos is constantly improving. At some point, you may wish to try the software version in the develop branch. Maybe there is a new feature, or a fix for a bug that hasn't got to the master branch yet...",
+            "updated": 1617007301530
         },
         {
             "style": "Success",
diff --git a/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.3-tutorial-step-now-the-current-branch.json b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.3-tutorial-step-now-the-current-branch.json
index bd279af24..4aaa034f8 100644
--- a/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.3-tutorial-step-now-the-current-branch.json
+++ b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.3-tutorial-step-now-the-current-branch.json
@@ -13,13 +13,13 @@
     "paragraphs": [
         {
             "style": "Text",
-            "text": "Now it's time to change the current branch. When you do that, the app will run a series of Git commands that will download the software from the develop branch of your fork! The current software will be replaced on your disk! For that reason, you will need to close the app after switching, restart, find the tutorial and resume!",
-            "updated": 1616873624278
+            "text": "Now it's time to change the Current Branch! When you do that, the app will run a series of Git commands that will download the software from the develop branch of your fork! The current software will be automatically replaced on your disk! For that reason, you will need to close the app after switching, restart, find the tutorial and resume to keep going!",
+            "updated": 1617017990927
         },
         {
-            "style": "Callout",
-            "text": "Go back to the footer and select Develop as your Current Branch. Follow the instructions to close the app when the process is done. When you restart, find the tutorial in the bottom-right corner of the workspace and select Resume in the menu!",
-            "updated": 1616873590554
+            "style": "Important",
+            "text": "But before you switch branches, let's take a moment to think of the consequences!",
+            "updated": 1617008246622
         }
     ]
 }
\ No newline at end of file
diff --git a/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.4-tutorial-step-welcome-back.json b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.4-tutorial-step-welcome-back.json
new file mode 100644
index 000000000..9fbb6f0a2
--- /dev/null
+++ b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.4-tutorial-step-welcome-back.json
@@ -0,0 +1,25 @@
+{
+    "tutorial": "Contribute to Superalgos!",
+    "pageNumber": "7.4",
+    "type": "Tutorial Step - Welcome Back!",
+    "definition": {
+        "text": "If you followed my instructions to the letter, you should now be running the software in the develop branch! Awesome!",
+        "icon": {
+            "name": "hits",
+            "project": "Superalgos"
+        },
+        "updated": 1617007379836
+    },
+    "paragraphs": [
+        {
+            "style": "Text",
+            "text": "The software you are currently running is the version of Superalgos that was at the develop branch the day you forked the project! This is because the process of switching branches downloads the software from your fork and not the upstream repository.",
+            "updated": 1617020053004
+        },
+        {
+            "style": "Success",
+            "text": "You need to update so that you run the latest version! This is particularly important when you intend to contribute to the project. You should always work on the latest version so that the changes you make include the latest changes produced by other contributors!",
+            "updated": 1617020167891
+        }
+    ]
+}
\ No newline at end of file
diff --git a/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.5-tutorial-step-update-the-app.json b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.5-tutorial-step-update-the-app.json
new file mode 100644
index 000000000..4c01bd13f
--- /dev/null
+++ b/Projects/Superalgos/Schemas/Docs-Tutorials/contribute-to-superalgos-7.5-tutorial-step-update-the-app.json
@@ -0,0 +1,33 @@
+{
+    "tutorial": "Contribute to Superalgos!",
+    "pageNumber": "7.5",
+    "type": "Tutorial Step - Update the App!",
+    "definition": {
+        "text": "The App Update Command fetches the latest version of the software from the upstream repository in the Current Branch!",
+        "icon": {
+            "name": "indicator-process-instance",
+            "project": "Superalgos"
+        },
+        "updated": 1617020636889
+    },
+    "paragraphs": [
+        {
+            "style": "Text",
+            "text": "That means that you may use this command on either of the branches! This is it:",
+            "updated": 1617020758219
+        },
+        {
+            "style": "Json",
+            "text": "app.update"
+        },
+        {
+            "style": "Callout",
+            "text": "Copy and run the command!"
+        },
+        {
+            "style": "Success",
+            "text": "Once the update is done, you will need to close the app again, restart it, find the tutorial and click Resume, just like you did earlier!",
+            "updated": 1617020620260
+        }
+    ]
+}
\ No newline at end of file