From a82959de1abc9919a9f55926be09918444354f03 Mon Sep 17 00:00:00 2001 From: Julian Molina Date: Thu, 8 Apr 2021 20:34:26 +0200 Subject: [PATCH] Notes on how to contribute tutorials --- Projects/Superalgos/Icons/Thumbs.db | Bin 6052864 -> 6075392 bytes ...algos-006-how-to-contribute-tutorials.json | 150 +++++++++++++----- 2 files changed, 112 insertions(+), 38 deletions(-) diff --git a/Projects/Superalgos/Icons/Thumbs.db b/Projects/Superalgos/Icons/Thumbs.db index 88827d9e046093ad2adc0a32ef16a7a11a8eae0d..2fc679ef35f4146ec233ba6c20c5fd7ffdf1fd09 100644 GIT binary patch delta 21922 zcmZVE1ymGY{4o4ky1Toj8|el`8U!gR0YMt11%~bvBori6K#&lmk)=agO1h;RVS#0N z=l6e}=e*B3&+PfYp53`QcfR-ToEz43iWatWhF0T-ftfj5k;ND3jnU|h0W*-wRxL0W zjr}JFgP=jsAs7%$2o?kzf&;;Y;6d;q1Q0?95rh~*0wINvHU5($*R3Fg(ZT>g8w~*N zp(C4A51k{{XNMd@0ilFYL8u`#5LyTwgdV~GVT3S2m?10>RtQ_8&kp;T3nA>k40ZnR zjI(`=IE-+dfd9L!3nPx$3nNYl7vuqi8^QzOZM-nz8+%6xtU?K5pi2J#6};Hvi@n(6 zhX_CfAwm#ghzLX!A_ftMNI)J!Bq34|X^0F&w((+5PR}U2TMt_#)<;nuq5x5ZC_$7V zDiBqO8blrP2=W-B0eJ$^glIvuAvzFUh#o{AVgNCOJcSrRj3Lh;CJyh+gcp=Lry`?0_)S~7v#MiFQ1GFXGF#g8};1vOm=I#n1V0uhCXLBt^v zkcSXSh!jK`A_I|y$U)>G3J^tz5=0sDUw*34e>I3YzGuZiTZjn~xIxBsdFBc;TBw)@oL_T#fk1!}c# z332PcOBF0CXJ!NqEhsPQjVlD6HN+{AWu;;2Uq+?L+mBiPZ4;9$t;|XL_p$l4W4krI z=t^^E+M@KmbX`7c82?5wrxsU)<})!gPz*s|Ey_|5#r?*9R`!^I%sPS}3%!Hw$LN?* zZ92(Yj`tYPzQts|GCRIst8r4IQt5TH_ij5^oNhUH(cmrGqcd$Lo5jTMl3b$0Vcr{| z7;?)M-`FvTHGM=C0keVa?(SwjR?6dESa+|g?q5>I?*fztx`Y9eT44epik|>IJ1m2c z9z59-!q?E#Gf4?2qj2C$Qcg$fOkbF-_Mp%)X&u-Mzu061neSU|!n zA{CpkNm!&MQJjgV?-4IDxhQ9P!98+%n;%J_dsc9j)wjcKTaFN-)ibNYhJRj62vaO*~1&(9kku6y$7T-r#$0Db9}G2`Cv- zi2Ri{GY@hsYYvRnD|$WV-AANO3)Pz2tpY6mY|oaN6*@eW9hSD4Ws*i}3lzrj@bR5f zWxtdE2Dq|DX-jsgD(T;z5UP+GJhuupP%@T0C+%=Y&&zABtzT$Er}B7MIVKhs)^e~pm=U6zmD$!w zt+>wI-JQ(M1(mG3VG&|(WECp#G&3aX_wngOyG~ow3kob?FZ1{B-%}Z1zIZ5e|M=*S zY%iwml_CJ91lz%BlLXy-b2{M9kSxj{fn6oW72&}pQ}L;{w>x3z*9?r+1y_lAB1s$S zzYO4kk;e5+1v^bYxPOVvOqOU9W-ifua>;E zRJ>m8X0&ZMo)DsZpj?R1f$;vrvl5-Wrgz8tio^ZnH&S1!qHO>c&(=Hz&0QP=HvG

H3DsdQD?ZW)lPSyvr~ZWKukB&_Hq6vz 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 SrDjk1-?W~j|Mcc7xc?6e?()F^ diff --git a/Projects/Superalgos/Schemas/Docs-Topics/contributing-to-superalgos-006-how-to-contribute-tutorials.json b/Projects/Superalgos/Schemas/Docs-Topics/contributing-to-superalgos-006-how-to-contribute-tutorials.json index 6264c6d42..b205fca85 100644 --- a/Projects/Superalgos/Schemas/Docs-Topics/contributing-to-superalgos-006-how-to-contribute-tutorials.json +++ b/Projects/Superalgos/Schemas/Docs-Topics/contributing-to-superalgos-006-how-to-contribute-tutorials.json @@ -117,55 +117,85 @@ "updated": 1617733117832 }, { - "style": "Subtitle", - "text": "One Call For Action Only" + "style": "Title", + "text": "Consistent Use of Space and Styles", + "updated": 1617904223037 }, { "style": "Text", - "text": "Each tutorial step should have a single call for action, that is, a single instruction that the user must carry out. This is the ideal case scenario. There may be exceptions, for example, when we ask the user to read a page in the Docs and do something else as the main instruction. ", - "updated": 1617720707328 + "text": "Use the different sections on the page and the different paragraph styles for consistent purposes. This helps users get accustomed to a certain format so that they know what to expect from each section of the page. Consistency in the way the information is delivered makes tutorials more usable!" + }, + { + "style": "Subtitle", + "text": "The Definition Box" + }, + { + "style": "Text", + "text": "The definition box is the space to the right of the icon, below the title. Use this space to introduce what the step is about, that is, to set up the story the step will tell, or to provide some basic context. ", + "updated": 1617902992986 + }, + { + "style": "Note", + "text": "To use the definition box correctly, explain the context in four to five lines. Avoid one or two lines or anything over five.", + "updated": 1617903200520 + }, + { + "style": "Subtitle", + "text": "The Call For Action" + }, + { + "style": "Text", + "text": "The most important section on any given step is the call for action, that is, the instruction that the user must follow to progress in the tutorial. Many times users redo tutorials or go back a few steps just to make sure they did everything right. ", + "updated": 1617904108044 + }, + { + "style": "Callout", + "text": "Always use the callout style — the one applied to this paragraph — for the call for action! Similarly, try to avoid using this style for anything else. If the particular step doesn't have a call for action, then the step should not feature this style at all!" + }, + { + "style": "Text", + "text": "Each tutorial step should have a single call for action, that is, a single instruction that the user must carry out. This is the ideal case scenario. There may be exceptions, for example, when we ask the user to read a page in the Docs and do something else as the main instruction.", + "updated": 1617904124728 }, { "style": "Success", "text": "In general terms and when possible, try to avoid giving the user more than one task on the same step. Instead, if you expect the user to perform several sequential actions, try to split the process into more than one step — as many as it takes.", - "updated": 1617721156206 + "updated": 1617904133804 + }, + { + "style": "Text", + "text": "In some cases, you may need the user to take a very simple action so that the main call for action may be delivered. In such cases, you may use the definition box to tell the user how to get ready to execute the call for action delivered later in the page." }, { "style": "Subtitle", - "text": "Consistent Use of Styles and Space", - "updated": 1617722131538 + "text": "Alternating Colors", + "updated": 1617906135945 }, { "style": "Text", - "text": "Use the different sections on the page and the different paragraph styles for consistent purposes. This helps users get accustomed to a certain format so that they know what to expect from each section of the page. Consistency in the way the information is delivered makes tutorials more usable!", - "updated": 1617733162806 + "text": "Colorful tutorial steps look great, while a white pages full of text feel too much like non-interactive documentation. Makes sure you break the monotony with the four different styles of boxes:", + "updated": 1617906625458 }, { - "style": "Text", - "text": "Consider the following:", - "updated": 1617722201424 + "style": "Success", + "text": "This is great for additional tips." }, { - "style": "Text", - "text": "The definition box is the space to the right of the icon, below the title. Use this space to introduce what the step is about, that is, to set up the story the step will tell, or to provide some basic context.", - "updated": 1617721881227 + "style": "Note", + "text": "Use this every once in a while to break up otherwise large sections of plain text." }, { - "style": "Callout", - "text": "The most important section on any given step is the call for action, that is, the instruction that the user must follow to progress in the tutorial. Many times users redo tutorials or go back a few steps just to make sure they did everything right. Always use the callout style — the one applied to this paragraph — for the call for action! Similarly, try to avoid using this style for anything else. If the particular step doesn't have a call for action, then the step should not feature this style at all!", - "updated": 1617733181730 + "style": "Important", + "text": "Leave this box for the truly important stuff. Things you don't want users to overlook or forget.", + "updated": 1617906591147 }, { - "style": "Text", - "text": "In some cases, you may need the user to take a very simple action so that the main call for action may be delivered. In such cases, you may use the definition box to tell the user how to get ready to execute the call for action delivered later in the page.", - "updated": 1617722090611 + "style": "Warning", + "text": "And this one, save it for real warnings. Things that may represent a threat or risk.", + "updated": 1617906578635 }, { - "style": "Text", - "text": "Use the rest of the styes to develop the content." - }, - { - "style": "Subtitle", + "style": "Title", "text": "Use of Docs Pages" }, { @@ -184,7 +214,7 @@ "updated": 1617733203373 }, { - "style": "Subtitle", + "style": "Title", "text": "Interactivity", "updated": 1617724494717 }, @@ -214,7 +244,12 @@ "updated": 1617733297397 }, { - "style": "Subtitle", + "style": "List", + "text": "In some cases, the actions users take may have certain effects. Showing users the outcome of their actions immediately after completing a task has a great educational value. For example, if the user is setting up a new Time Machine in a tutorial about the Charting Space, show users how the time machine appears in the charting space immediately after creating it. If users then set up a Timeline Chart that references a particular Data Mine, show users how the new Timeline Chart appears within the Time Machine, and let them verify that the expected layer managers are there. Don't be afraid to go back and forth... that is the whole point after all!", + "updated": 1617905020985 + }, + { + "style": "Title", "text": "Tooltips", "updated": 1617731886888 }, @@ -233,7 +268,7 @@ "updated": 1617733407351 }, { - "style": "Subtitle", + "style": "Title", "text": "Naming of Nodes", "updated": 1617731585276 }, @@ -276,15 +311,6 @@ "text": "Here's a list of requirements that help tutorials be consistent in their look & feel:", "updated": 1617722868882 }, - { - "style": "List", - "text": "Always use proper title case for titles.", - "updated": 1617722923539 - }, - { - "style": "List", - "text": "Titles look best when they span a single line. Use two-line titles only if strictly necessary!" - }, { "style": "List", "text": "Always use an icon to illustrate the step. Sometimes the appropriate icon is the one corresponding to the node the user is working with. Other times you may use icons figuratively, playing with alternate meanings of what the drawing may represent." @@ -304,6 +330,54 @@ "text": "Do not set two consecutive paragraphs with the same style. The only exception is for bullet lists. Even the Docs Text Style is not formated to look good as consecutive paragraphs in the context of a tutorial (there is no padding between paragraphs).", "updated": 1617723650896 }, + { + "style": "Title", + "text": "Titles" + }, + { + "style": "Text", + "text": "Always use proper title case for titles. But, what exactly is proper title case? Let's agree to the standard propose in this blog post:", + "updated": 1617902503383 + }, + { + "style": "Link", + "text": "Capitalization of titles 101->www.grammarcheck.net/capitalization-in-titles-101/", + "updated": 1617902444077 + }, + { + "style": "Success", + "text": "Titles look best when they span a single line. Use two-line titles only if strictly necessary!", + "updated": 1617902549247 + }, + { + "style": "Subtitle", + "text": "Unique Identifiers", + "updated": 1617905396529 + }, + { + "style": "Important", + "text": "Remember that the title of a tutorial step is also the unique identifier of the corresponding Docs Page. This means that the system does not allow for duplicate titles. Avoid at all costs naming pages after single words or short phrases. Let's leave those unique names for particular cases that may merit the use of such special phrases." + }, + { + "style": "Text", + "text": "For the same reason, all titles should begin with the following fixed string of text:", + "updated": 1617905464492 + }, + { + "style": "Json", + "text": "Tutorial Step - ", + "updated": 1617905492001 + }, + { + "style": "Text", + "text": "The above helps reserve some phrases for contexts different than tutorials.", + "updated": 1617905844332 + }, + { + "style": "Success", + "text": "Don't worry! Your titles will not look ugly in the tutorial, as the system filters the prefix and doesn't show it in the tutorial window!", + "updated": 1617905922481 + }, { "style": "Title", "text": "Proper English",