[{"data":1,"prerenderedAt":108},["ShallowReactive",2],{"page-comandi-\u002Fcomandi\u002Fcommenti":3},{"id":4,"title":5,"body":6,"catcomando":98,"descComando":99,"description":16,"extension":100,"meta":101,"navigation":103,"path":104,"seo":105,"stem":106,"__hash__":107},"comandi\u002Fcomandi\u002Fcommenti.md","Commenti",{"type":7,"value":8,"toc":94},"minimark",[9,13,17,27,30,41,46,49,52,55,63,74,80,85,88],[10,11,5],"h1",{"id":12},"commenti",[14,15,16],"p",{},"Ci sono due modi per commentare un algoritmo Black3",[18,19,20,24],"ol",{},[21,22,23],"li",{},"Commento in linea",[21,25,26],{},"Commento multilinea",[14,28,29],{},"Esempio 1",[31,32,37],"pre",{"className":33,"code":35,"language":36},[34],"language-text","$b3[1][OBJ]{         \n   \u002F\u002F questo è un commento in linea         \n   ...  \n}  \n\n$b3[2][OBJ]{         \n   \u002F* questo è un commento multilinea \n   perchè posso scriverlo \n   su più linee *\u002F         \n...  }\n","text",[38,39,35],"code",{"__ignoreMap":40},"",[42,43,45],"h2",{"id":44},"best-practice","Best Practice",[14,47,48],{},"I commenti sono utili per annotazioni veloci su modifiche da effettuare all’algoritmo Black3 e per descrivere in modo specifico le operazioni da effettuare con i comandi.",[14,50,51],{},"I commenti non possono avere carattere algoritmico. Ne consegue che un commento non può essere soggetto all’esecuzione di alcun comando all’interno dell’algoritmo.",[14,53,54],{},"Non è quindi possibile utilizzare i commenti con la stessa logica di un comando.",[14,56,57,58,62],{},"Nel caso in cui un commento serva per dichiarare l’intenzione di apportare modifiche, ",[59,60,61],"strong",{},"a modifiche effettuate"," il commento dovrebbe essere immediatamente rimosso o modificato secondo esigenza. Questo per evitare confusione o errori interpretativi dell’algoritmo, soprattutto in un ambiente che sfrutta diverse recipe.",[14,64,65,66,73],{},"Nel caso in cui sia necessario inserire nel workflow un commento di natura algoritmica si deve utilizzare il comando ",[38,67,68],{},[69,70,72],"a",{"href":71},"\u002Fcomandi\u002Fnote","NOTE",".",[14,75,76,79],{},[59,77,78],{},"NB:"," questo aspetto va tenuto in debita considerazione soprattutto dal punto di vista delle recipe scambiate tra due o più sviluppatori Black3 (multiutenza).",[14,81,82],{},[59,83,84],{},"L’algoritmo ha validità solamente nell’ambito dell’esecuzione dei comandi.",[14,86,87],{},"Assegnare quindi un comando o segnalarlo ad un altro programmatore tramite recipe usando un commento non può essere considerata un’operazione algoritmica.",[14,89,90,91,73],{},"I commenti servono agli sviluppatori esclusivamente ",[59,92,93],{},"per ragionare sul codice, per spiegare alcuni passaggi, per suggerire modifiche ecc",{"title":40,"searchDepth":95,"depth":95,"links":96},2,[97],{"id":44,"depth":95,"text":45},null,"crea un comment nell'algoritmo","md",{"catComando":102},"abc",true,"\u002Fcomandi\u002Fcommenti",{"title":5,"description":16},"comandi\u002Fcommenti","9SjesJxa0TYVSyejIN5WiWaMnP9vtymo45QgWrULoAo",1777192318614]