This is my contribution to Superalgos
This commit is contained in:
EvaMaria70 committed
1 parent
c445691bc9
commit
f4faf0959e
1 file changed
+140
-21
+140
-21
@@ -248,8 +248,8 @@
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Elegims enfocarnos en construirtutoriales comprensibles que todos puedan seguir y que no deje a nadie atrás. Creemos que un tutorial que va lento, cubriendo cada detalle, y tomándose el tiempo de explicar los matices es el enfoque correcto en esta etapa. Al construir tutoriales de esta manera, garantizamosque aquellos que están dispuestos a invertir tiempo en aprender el sistema tengan el material adecuado para convertirse rápidamente en usuarios poderosos.",
|
||||
"updated": 1633367871109
|
||||
"text": "Elegimos enfocarnos en construirtutoriales comprensibles que todos puedan seguir y que no deje a nadie atrás. Creemos que un tutorial que va lento, cubriendo cada detalle, y tomándose el tiempo de explicar los matices es el enfoque correcto en esta etapa. Al construir tutoriales de esta manera, garantizamos que aquellos que están dispuestos a invertir tiempo en aprender el sistema tengan el material adecuado para convertirse rápidamente en usuarios poderosos.",
|
||||
"updated": 1633437811992
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -289,8 +289,8 @@
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Los tutoriales de Superalgos han evolucionado a lo largo de varios meses valiosos feedbacks de los primeros usuarios. Sentimos que hemos encontrado un modo propio, y hemos comenzado a desarrollar un estilo en el modo en que utilizamos el espacio disponible en cada paso de un tutorial. A continuaciòn algunas notas que le ayudará a construir tutoriales ue combine con el formato de los tutoriales existentes.",
|
||||
"updated": 1633368515189
|
||||
"text": "Los tutoriales de Superalgos han evolucionado a lo largo de varios meses valiosos feedbacks de los primeros usuarios. Sentimos que hemos encontrado un modo propio, y hemos comenzado a desarrollar un estilo en el modo en que utilizamos el espacio disponible en cada paso de un tutorial. A continuaciòn algunas notas que le ayudará a construir tutoriales que combinen con el formato de los tutoriales existentes.",
|
||||
"updated": 1633437837617
|
||||
}
|
||||
]
|
||||
},
|
||||
@@ -407,16 +407,37 @@
|
||||
{
|
||||
"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
|
||||
"updated": 1617904124728,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Cada paso del tutorial debería tener un solo llamado a la acción, esto es, una sola instrucciòn que el usuario debe llevar a cabo. Puede haber excepciones, por ejemplo, cuando le solicitamos al usuario que lea una página en los docs y hacer algo más como la instrucción principal.",
|
||||
"updated": 1633438088497
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"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": 1617904133804
|
||||
"updated": 1617904133804,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "En términos generales y cuando es posible, intente evitar darle al usuario más de una tarea en el mismo paso. En vez de eso, si espera que el usuario haga varias acciones secuencialmente, intente repartir el proceso en más de un paso — tantos como sean necesarios.",
|
||||
"updated": 1633438316138
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"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."
|
||||
"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.",
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "En algunos casos, puede necesitar que el usuario haga una acción muy simple para que el principal llamado a la acción pueda realizarse. En esos casos, puede utilizar la definition box para decirle al usuario como estar listo para ejecutar el llamado a la acción, que será entregado mas adelante en la ´pagina.",
|
||||
"updated": 1633438618455
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "Subtitle",
|
||||
@@ -426,25 +447,60 @@
|
||||
{
|
||||
"style": "Text",
|
||||
"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
|
||||
"updated": 1617906625458,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Pasos de tutoriales coloridos se ven muy bien, mientras que las páginas blancas llenas de texto se sienten como documentación muy poco interactiva. Asegúrese de romper la monotonía con los cuatro estilos diferentes de boxes.",
|
||||
"updated": 1633438835567
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "Success",
|
||||
"text": "This is great for additional tips."
|
||||
"text": "This is great for additional tips.",
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Esto es genial para tips adicionales.",
|
||||
"updated": 1633438870414
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "Note",
|
||||
"text": "Use this every once in a while to break up otherwise large sections of plain text."
|
||||
"text": "Use this every once in a while to break up otherwise large sections of plain text.",
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Use este cada tanto para romper secciones grandes de puro texto.",
|
||||
"updated": 1633439032601
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "Important",
|
||||
"text": "Leave this box for the truly important stuff. Things you don't want users to overlook or forget.",
|
||||
"updated": 1617906591147
|
||||
"updated": 1617906591147,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Deje esta box para cosas verdaderamente importantes. Cosas que no quiere que los usuarios se pasen por alto o se olviden.",
|
||||
"updated": 1633439143351
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "Warning",
|
||||
"text": "And this one, save it for real warnings. Things that may represent a threat or risk.",
|
||||
"updated": 1617906578635
|
||||
"updated": 1617906578635,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Y esta otra, guárdela para advertencias reales. Cosas que pueden representar una amenaza o un riesgo.",
|
||||
"updated": 1633439239739
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "Title",
|
||||
@@ -453,17 +509,38 @@
|
||||
{
|
||||
"style": "Text",
|
||||
"text": "When you need the user to learn about a specific concept to get the proper context on the subject, do not replicate in the tutorial information that exists in the Docs. Duplicating information is not a good idea, as it makes it harder to maintain the Docs and tutorials.",
|
||||
"updated": 1617730695174
|
||||
"updated": 1617730695174,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Cuando necesite que el usuario aprenda un concepto específico para obtener un contexto adecuado del tema, no repita en el tutorial la información que ya existe en los Docs. Duplicar la información no es una buena idea, ya que hace mas difícil mantener los Docs y los tutoriales.",
|
||||
"updated": 1633439488393
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "Success",
|
||||
"text": "Asking the user to read a page or a section of a page in the Docs is the correct approach. This has the added benefit of making the user aware that the Docs cover the topic too.",
|
||||
"updated": 1617724009821
|
||||
"updated": 1617724009821,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Pedirle al usuario leer una página o una parte de la página en los Docs es el acercamiento adecado. Esto tiene el beneficio adicional de hacer que el usuario se de cuenta de que los Docs también cubren el tópico.",
|
||||
"updated": 1633439691786
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "Important",
|
||||
"text": "If you find that the relevant page in the Docs is outdated, doesn't cover the topic with the appropriate depth, or maybe even doesn't exist, helping create, complete, and/or improve the delivery of the information in the Docs is just as valuable as building the tutorial! Long format explanations do not fit well in tutorials. They do fit well in the Docs!",
|
||||
"updated": 1617733203373
|
||||
"updated": 1617733203373,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Si encuentra que la página relevante de los Docs está desactualizada, no cubre el tópico con la profundidad apropiada, o puede que no exista, ayudar a crearla, completar, y/o mejorar el envio de la información en los Docs es tan valioso como construir el tutorial! Explicaciones en formato largo no encajan bien con los tutoriales. Ellas van bien en los Docs!",
|
||||
"updated": 1633440056942
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "Title",
|
||||
@@ -473,32 +550,74 @@
|
||||
{
|
||||
"style": "Text",
|
||||
"text": "The whole point of tutorials — and the main difference with the Docs as learning material — is that they offer the opportunity for hands-on learning. Tutorials are interactive while the Docs are less so!",
|
||||
"updated": 1617730782624
|
||||
"updated": 1617730782624,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "El punto de los tutoriales — y la diferencia principal con los Docs como material de aprendizaje — es que ellos ofrecen la oportunidad para el aprendizaje práctico Los tutoriales son interactivos mientras que los Docs no tanto!",
|
||||
"updated": 1633440286430
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "Callout",
|
||||
"text": "Make sure you use this quality to the fullest, but also try to maintain a certain balance!",
|
||||
"updated": 1617725782977
|
||||
"updated": 1617725782977,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Asegúrese de usar esta cualidad a máximo, pero tambien intente mantener un cierto balance!",
|
||||
"updated": 1633440365877
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "List",
|
||||
"text": "If the tutorial is talking about a hierarchy, a group of nodes, or a particular node, make sure that the tutorial step takes you to that place in the Workspace. This adds a visual element to the explanation and helps the user get familiar with the data structures involved.",
|
||||
"updated": 1617725808080
|
||||
"updated": 1617725808080,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Si el tutorial está hablando de jerarquías, un grupo de nodos en particular, asegúrese que el paso del tutorial lo lleve a ese lugar en el Workspace. Esto agrega un elemento visual a la explaicación y ayuda al usuario a familiarizarse con la estructura de datos involucrada.",
|
||||
"updated": 1633440573331
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "List",
|
||||
"text": "Tutorials can affect the Workspace in many ways replicating actions the user may do. When you want the user to learn to do something, it's best to ask the user to do it, instead of having the tutorial do it for the user.",
|
||||
"updated": 1617733271488
|
||||
"updated": 1617733271488,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Los tutoriales pueden afectar al Workspace de muchas maneras replicando acciones que el usuario puede hacer. Cuando quiere que el usuario aprenda a hacer algo, lo mejor es pedirle al usuario que lo haga, en vez de que el tutorial lo haga por él.",
|
||||
"updated": 1633440813684
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "List",
|
||||
"text": "On the other hand, the tutorial should take care of doing certain things that are not conducive to learning something relevant to the context of the tutorial. Performing these actions directly may help keep the user focused on what matters most.",
|
||||
"updated": 1617733297397
|
||||
"updated": 1617733297397,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "Por otro lado, el tutorial debería cuidar de no hacer cosas que no lleven a aprender nada reevante del contexto del tutorial. Realizar estas acciones directamente puede ayudar a mantener al usuario concentrado en lo que más importa.",
|
||||
"updated": 1633440988592
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"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
|
||||
"updated": 1617905020985,
|
||||
"translations": [
|
||||
{
|
||||
"language": "ES",
|
||||
"text": "En algunos casos, las acciones que los usuarios realizan tienene efectos determinados. Mostrales a los usuarios los resultados de sus acciones inmediatamente después de haber completado una tarea es de gran valor educativo. Por ejemplo, si el usuarioestá configurando una nueva Time Machine en un tutorial a cerca de el Charting Space, mostrale a a os usuarios como la time machine aparece en el charting space inmediatamente después de crearla. Si los usuarios configuran una Timeline Chart que referencia a una particular Data Mine, mostrarles a los usuarios como la nueva Timeline Chart aparece dentro de la Time Machine, y permitéles verificar que los administradores de capas esperados están allí. no tengas miedo de ir hacia atrás y hacia adelante... Ese es el punto después de todo!",
|
||||
"updated": 1633441873892
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"style": "Title",
|
||||
|
||||
Reference in new issue
Block a user