From 69f6c6c5f37b61a91f7b62be720d031e3e24a7f9 Mon Sep 17 00:00:00 2001 From: EvaMaria70 Date: Sat, 2 Oct 2021 15:11:34 +0200 Subject: [PATCH 1/8] This is my contribution to Superalgos --- ...p-commands-001-app-contribute-command.json | 57 +++++++++++++-- ...os-005-how-to-contribute-translations.json | 72 ++++++++++++++++--- .../docs-languages-002-docs-in-spanish.json | 4 +- .../contribution-claims.json | 18 ++++- 4 files changed, 132 insertions(+), 19 deletions(-) diff --git a/Projects/Foundations/Schemas/Docs-Topics/A/App/App-Commands/app-commands-001-app-contribute-command.json b/Projects/Foundations/Schemas/Docs-Topics/A/App/App-Commands/app-commands-001-app-contribute-command.json index e7861921b..5482254f4 100644 --- a/Projects/Foundations/Schemas/Docs-Topics/A/App/App-Commands/app-commands-001-app-contribute-command.json +++ b/Projects/Foundations/Schemas/Docs-Topics/A/App/App-Commands/app-commands-001-app-contribute-command.json @@ -9,7 +9,8 @@ { "language": "ES", "text": "Este comando te permite contribuir con trabajo al proyecto. El aporte va al repositorio de Superalgos a través de un Pull Request de tu fork de Superalgos.", - "updated": 1628205171216 + "updated": 1628205171216, + "style": "Definition" } ] }, @@ -17,31 +18,73 @@ { "style": "Text", "text": "This command will send all changes you have made in Docs pages but also on any file within the Superalgos folder (except for My-Workspaces, Data-Storage, and My-Logs folders) to your fork at Github.com. It will also send them from your fork to the main Superalgos Repository. It will do it specifically from the Current Branch to the Contributions Branch mentioned at the footer of this page.", - "updated": 1622028842412 + "updated": 1622028842412, + "translations": [ + { + "language": "ES", + "text": "Este comando envia todos los cambios que hayas hecho en las paginas de documentos pero también de but also en cualquier archivo de la carpeta de Superalgos (a excepción de My-Workspaces, Data-Storage, (Archivo de datos de mi espacio de trabajo) y My-Logs folders (mis carpetas de registros) a tu bifurcación en Github.com. También serán enviados desde tu bifurcación al repositorio principal de Superalgos Lo hará específicamente desde la rama actual a la rama de las contribuciones mencionados al final de ésta página.", + "updated": 1633175695567 + } + ] }, { "style": "Warning", "text": "Never use your Superalgos folder to store personal files, as the whole folder but the few exceptions mentioned above are subject to be sent over the Internet to a public site.", - "updated": 1622029162278 + "updated": 1622029162278, + "translations": [ + { + "language": "ES", + "text": "Nunca utilice su carpeta de Superalgos para almacenar archivos personales, ya que toda la carpeta, salvo las pocas excepciones mencionadas arriba, están sujetas a ser enviadas a través de internet a un sitio público.", + "updated": 1633175880707 + } + ] }, { "style": "Important", "text": "In most cases, contributions must go from the develop branch to the develop branch, or from the plugins-docs branch to the plugins-docs branch, unless you have previously agreed with team members that you will send a contribution from master to master.", - "updated": 1622028905753 + "updated": 1622028905753, + "translations": [ + { + "language": "ES", + "text": "En la mayoría de los casos,, las contribuciones deben ir desde la rama de desarrollo a la rama de desarrollo, o desde la rama de plugins-docs (documentos complementarios) a la rama de plugins-docs, salvo que previamente haya acordado con los miembros del equipo que enviará una contribución de master a master.", + "updated": 1633176160361 + } + ] }, { "style": "Text", "text": "Master is our stable branch and it is very unlikely that we are going to merge contributions there. Instead, all contributions are expected to go to the develop or the plugins-docs branches, where many users are testing that branch every day. Contributions of plugins and Docs may reach the master branch often. Contributions to the develop branch will reach the master branch on the next release.", - "updated": 1622029260459 + "updated": 1622029260459, + "translations": [ + { + "language": "ES", + "text": "Master ( Maestra) es una rama estable y es muy poco porbable que vayamos a emerger contribuciones allí. En cambio todas las contribuciones se espera que vayan a as ramas de desarrollo o de documentos complementarios, donde muchos usuarios están chequeando esa rama cada día. Las contribuciones de enchufes o documentos puede alcanzar a maenudo la rama maestra. Contribuciones a la rama de desarrollo llegará a la rama maestra en la siguiente liberación.", + "updated": 1633176639433 + } + ] }, { "style": "Note", "text": "It is also very unlikely that contributions coming from the master branch will be merged into the develop branch, since that can usually lead to merging conflicts.", - "updated": 1622029116935 + "updated": 1622029116935, + "translations": [ + { + "language": "ES", + "text": "Es también muy poco probable que las contribuciones provenientes de la rama maestra será traída en la rama de desarrollo, ya que ello puede provocar que emergan conflictos.", + "updated": 1633176834093 + } + ] }, { "style": "Success", - "text": "Check the footer of the Docs to verify what branches you are operating with before submitting your contributions!" + "text": "Check the footer of the Docs to verify what branches you are operating with before submitting your contributions!", + "translations": [ + { + "language": "ES", + "text": "Chequear el pie de los documentos par qverificar que en que ramas está operando antes de enviar su contribución", + "updated": 1633176955159 + } + ] }, { "style": "Title", diff --git a/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-005-how-to-contribute-translations.json b/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-005-how-to-contribute-translations.json index 80db348fc..5cb18ef34 100644 --- a/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-005-how-to-contribute-translations.json +++ b/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-005-how-to-contribute-translations.json @@ -4,23 +4,51 @@ "type": "How to Contribute Translations", "definition": { "text": "The Docs are originally written in English. Making Superalgos more accessible is a key endeavor to grow the Community and the user base. Translating tutorials and software documentation into languages other than English is of huge value!", - "updated": 1613822257340 + "updated": 1613822257340, + "translations": [ + { + "language": "ES", + "text": "Los Docs (documentos) son originalmente escritos en Ingles. Hacer a Superalgos más accesible es un esfuerzo clave para el crecimiento de la comunidad y la base de usuarios. Traducir tutoriales y documentación del software a otros idiomas que no sean el Inglés es un aporte muy valioso!", + "updated": 1633170996967 + } + ] }, "paragraphs": [ { "style": "Title", "text": "Read About Contributing to the Docs", - "updated": 1613822300139 + "updated": 1613822300139, + "translations": [ + { + "language": "ES", + "text": "Read About Contributing to the Docs (Leer sobre como contribuir a los Docs)", + "updated": 1633171160951 + } + ] }, { "style": "Text", "text": "Translations are a particular case of contributing to the Docs. Please read the How to Contribute to the Docs page first, and come back here for the details about how we deal with translations in particular.", - "updated": 1613822394353 + "updated": 1613822394353, + "translations": [ + { + "language": "ES", + "text": "Las traducciones son un caso particular de contribuir con los documentos. Por favor leer primero la página de como contribuir con los documentos, y regresar aqui para los detalles de como nosotros nos manejamos particularmente con las traducciones.", + "updated": 1633171406067 + } + ] }, { "style": "Title", "text": "About Translations", - "updated": 1613822457097 + "updated": 1613822457097, + "translations": [ + { + "language": "ES", + "text": "About Translations ( Acerca de las traducciones)", + "updated": 1633171444432 + } + ] }, { "style": "Include", @@ -30,22 +58,50 @@ { "style": "Text", "text": "The system stores the content of each Docs Page in a single file, regardless of how many translations may exist for each page.", - "updated": 1613822896070 + "updated": 1613822896070, + "translations": [ + { + "language": "ES", + "text": "El sistema guarda el contenido de cada pagina de los Documentos en un solo archivo, independientemente de cuantas traducciones existan por cada página.", + "updated": 1633171834036 + } + ] }, { "style": "Text", "text": "Actually, translations exist at the level of each paragraph. This means that, for each paragraph in a page, there may be as many translations as there are supported languages.", - "updated": 1613825539396 + "updated": 1613825539396, + "translations": [ + { + "language": "ES", + "text": "Actualmente, existen al nivel de cada párrafo. Esto significa que, por cada párrafo de la página, puede haber tantas traducciones como lenguages de soporte hayan.", + "updated": 1633171706597 + } + ] }, { "style": "Success", "text": "The above doesn't affect your work directly, but it is worth noting because it means that many contributors may be working on the same page at any point in time. Hence the need to constantly update and to submit contributions frequently.", - "updated": 1613823174025 + "updated": 1613823174025, + "translations": [ + { + "language": "ES", + "text": "Lo mencionado no afecta su trabajo directamente,pero es bueno tenerlo en cuenta ya que significa que muchos contribuyentes pueden estar trabajando la misma página al mismo tiempo. He aqui la necesidad de actualizar constantemente y de solicitar la contribución a menudo.", + "updated": 1633172414535 + } + ] }, { "style": "Title", "text": "Best Practices", - "updated": 1613824072677 + "updated": 1613824072677, + "translations": [ + { + "language": "ES", + "text": "Best Practices (Las mejores prácticas)", + "updated": 1633172460565 + } + ] }, { "style": "List", diff --git a/Projects/Foundations/Schemas/Docs-Topics/D/Docs/Docs-Languages/docs-languages-002-docs-in-spanish.json b/Projects/Foundations/Schemas/Docs-Topics/D/Docs/Docs-Languages/docs-languages-002-docs-in-spanish.json index 9f37df345..08c871762 100644 --- a/Projects/Foundations/Schemas/Docs-Topics/D/Docs/Docs-Languages/docs-languages-002-docs-in-spanish.json +++ b/Projects/Foundations/Schemas/Docs-Topics/D/Docs/Docs-Languages/docs-languages-002-docs-in-spanish.json @@ -8,8 +8,8 @@ "translations": [ { "language": "ES", - "text": "Si bien la documentación esta originalmente escrita en Inglés, el sistema permite a cualquier usuario buscar contenido en su idioma nativo, siempre y cuando otros usuarios hayan contribuído traducciones de los artículos existentes escritos en el idioma por defecto que es el idioma Inglés.", - "updated": 1609831843644, + "text": "Si bien la documentación esta originalmente escrita en Inglés, el sistema permite a cualquier usuario buscar contenido en su idioma nativo, siempre y cuando otros usuarios hayan contribuído traducciones de los artículos existentes escritos en el idioma por defecto que es el idioma Inglés. Advertencia!!! Los documentos de Superalgos y de otros proyectos integrados están escritos originariamente en Inglés. El sistema permite a los usuarios buscar y navegar en páginas en toros idiomas también , siempre que algunos usuarios hayan contribuido con las correspondientes traduccciones. Por favor actualice esta traucción.", + "updated": 1633180141328, "style": "Definition" } ] diff --git a/Projects/Governance/Schemas/Docs-Concepts/C/Contribution/Contribution-Claims/contribution-claims.json b/Projects/Governance/Schemas/Docs-Concepts/C/Contribution/Contribution-Claims/contribution-claims.json index 6789ecf8e..c9a91b3ed 100644 --- a/Projects/Governance/Schemas/Docs-Concepts/C/Contribution/Contribution-Claims/contribution-claims.json +++ b/Projects/Governance/Schemas/Docs-Concepts/C/Contribution/Contribution-Claims/contribution-claims.json @@ -2,12 +2,26 @@ "type": "Contribution Claims", "definition": { "text": "The term Contribution Claims is a generalization of the concept of claims and may refer to any or all of the existing types, namely Asset Contribution Claim, Feature Contribution Claim, and Position Contribution Claim nodes.", - "updated": 1630351499915 + "updated": 1630351499915, + "translations": [ + { + "language": "ES", + "text": "El término Contribution Claims ( declaración de contribución) es una generalización del concepto reclamo y puede referirse a cualquiera o a todos los tipos existentes, a saber Asset Contribution Claim (declaración de contribución de activos), Feature Contribution Claim ( declaración de contribución de funciones), and Position Contribution Claim nodes (declaraciónde contribución de posición de nodos).", + "updated": 1633179306733 + } + ] }, "paragraphs": [ { "style": "Text", - "text": "Right click and Edit to enter edit mode and change this text. ENTER to write new paragraphs. ESC to exit edit mode. Then you can use docs.save to save your changes and app.contribute to send it to the main repository." + "text": "Right click and Edit to enter edit mode and change this text. ENTER to write new paragraphs. ESC to exit edit mode. Then you can use docs.save to save your changes and app.contribute to send it to the main repository.", + "translations": [ + { + "language": "ES", + "text": "Cliquear botón derecho y editar para entrar en el modo edición y cambiar este texto. ENTER para escribir parrafos nuevos. ESC para salir del modo edición. Entonces puede escribir docs.save arriba y ENTER para guardar los cambios y app.contribute ENTER para enviarlos al repositorio principal.", + "updated": 1633179602447 + } + ] } ] } \ No newline at end of file From 7e4484f0b062799fb55bc9eff2dbf8d4f8f87d21 Mon Sep 17 00:00:00 2001 From: EvaMaria70 Date: Sun, 3 Oct 2021 20:13:36 +0200 Subject: [PATCH 2/8] This is my contribution to Superalgos --- ...nity-workspaces-001-plugin-workspaces.json | 12 +- ...os-005-how-to-contribute-translations.json | 132 +++++++++++++++--- ...01-community-effort-to-test-exchanges.json | 63 ++++++++- ...ion-043-tutorial-step-placing-plugins.json | 4 +- ...orial-step-non-persistence-of-changes.json | 26 +++- ...-tutorial-step-starting-from-a-plugin.json | 12 +- ...-047-tutorial-step-improving-a-plugin.json | 2 +- 7 files changed, 207 insertions(+), 44 deletions(-) diff --git a/Projects/Foundations/Schemas/Docs-Topics/C/Community/Community-Workspaces/community-workspaces-001-plugin-workspaces.json b/Projects/Foundations/Schemas/Docs-Topics/C/Community/Community-Workspaces/community-workspaces-001-plugin-workspaces.json index cd41f8a84..a030dd605 100644 --- a/Projects/Foundations/Schemas/Docs-Topics/C/Community/Community-Workspaces/community-workspaces-001-plugin-workspaces.json +++ b/Projects/Foundations/Schemas/Docs-Topics/C/Community/Community-Workspaces/community-workspaces-001-plugin-workspaces.json @@ -9,7 +9,8 @@ { "language": "ES", "text": "Superalgos conecta con varios plugin workspaces configurados por la comunidad para facilitar la incorporación de usuarios. Este tema cubre cada uno de ellos y explica su propósito.", - "updated": 1628037130662 + "updated": 1628037130662, + "style": "Definition" } ] }, @@ -17,7 +18,14 @@ { "style": "Text", "text": "Each plugin workspace shipping with Superalgos was built with a specific purpose. ", - "updated": 1616172565179 + "updated": 1616172565179, + "translations": [ + { + "language": "ES", + "text": "Cada plugin workspace incluído en Superalgos ha sido cnstruido para un propósito específico.", + "updated": 1633281831625 + } + ] } ] } \ No newline at end of file diff --git a/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-005-how-to-contribute-translations.json b/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-005-how-to-contribute-translations.json index 5cb18ef34..bd06ddcfe 100644 --- a/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-005-how-to-contribute-translations.json +++ b/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-005-how-to-contribute-translations.json @@ -9,7 +9,8 @@ { "language": "ES", "text": "Los Docs (documentos) son originalmente escritos en Ingles. Hacer a Superalgos más accesible es un esfuerzo clave para el crecimiento de la comunidad y la base de usuarios. Traducir tutoriales y documentación del software a otros idiomas que no sean el Inglés es un aporte muy valioso!", - "updated": 1633170996967 + "updated": 1633170996967, + "style": "Definition" } ] }, @@ -22,7 +23,8 @@ { "language": "ES", "text": "Read About Contributing to the Docs (Leer sobre como contribuir a los Docs)", - "updated": 1633171160951 + "updated": 1633171160951, + "style": "Title" } ] }, @@ -34,7 +36,8 @@ { "language": "ES", "text": "Las traducciones son un caso particular de contribuir con los documentos. Por favor leer primero la página de como contribuir con los documentos, y regresar aqui para los detalles de como nosotros nos manejamos particularmente con las traducciones.", - "updated": 1633171406067 + "updated": 1633171406067, + "style": "Text" } ] }, @@ -46,7 +49,8 @@ { "language": "ES", "text": "About Translations ( Acerca de las traducciones)", - "updated": 1633171444432 + "updated": 1633171444432, + "style": "Title" } ] }, @@ -63,7 +67,8 @@ { "language": "ES", "text": "El sistema guarda el contenido de cada pagina de los Documentos en un solo archivo, independientemente de cuantas traducciones existan por cada página.", - "updated": 1633171834036 + "updated": 1633171834036, + "style": "Text" } ] }, @@ -75,7 +80,8 @@ { "language": "ES", "text": "Actualmente, existen al nivel de cada párrafo. Esto significa que, por cada párrafo de la página, puede haber tantas traducciones como lenguages de soporte hayan.", - "updated": 1633171706597 + "updated": 1633171706597, + "style": "Text" } ] }, @@ -87,7 +93,8 @@ { "language": "ES", "text": "Lo mencionado no afecta su trabajo directamente,pero es bueno tenerlo en cuenta ya que significa que muchos contribuyentes pueden estar trabajando la misma página al mismo tiempo. He aqui la necesidad de actualizar constantemente y de solicitar la contribución a menudo.", - "updated": 1633172414535 + "updated": 1633172414535, + "style": "Success" } ] }, @@ -99,68 +106,153 @@ { "language": "ES", "text": "Best Practices (Las mejores prácticas)", - "updated": 1633172460565 + "updated": 1633172460565, + "style": "Title" } ] }, { "style": "List", "text": "As explained in the How to Contribute to the Docs page, you must switch your Contributions Branch and your Current Branch to the develop branch. Remember to restart the app after the switch.", - "updated": 1616762259778 + "updated": 1616762259778, + "translations": [ + { + "language": "ES", + "text": "Como fue explicado en la página de How to Contribute to the Docs, debe cambiar su Contributions Branch (rama de contribución) y su Current Branch (rama actual) a la rama de desarrollo. Recuerde de recomenzar la app luego del cambio.", + "updated": 1633277617230 + } + ] }, { "style": "List", "text": "Make sure your system is up to date running the app.update command.", - "updated": 1616762308286 + "updated": 1616762308286, + "translations": [ + { + "language": "ES", + "text": "Asegúrese de que sus sitema esté actualizado haciendo correr el comando app.update.", + "updated": 1633277826500 + } + ] }, { "style": "List", - "text": "Then, switch to the language you wish to translate to." + "text": "Then, switch to the language you wish to translate to.", + "translations": [ + { + "language": "ES", + "text": "Entonces, cambie el idioma al cual desea traducir.", + "updated": 1633277782209 + } + ] }, { "style": "List", "text": "To translate a paragraph, right-click to edit the content and replace the English text with your translation. That's it!", - "updated": 1613825599051 + "updated": 1613825599051, + "translations": [ + { + "language": "ES", + "text": "Para traducir un párrafo cliquear botón derecho editar el contenido y reemplace e texto en Inglés con su traducción. Eso es!", + "updated": 1633277934174 + } + ] }, { "style": "List", "text": "You may find it easier to write your translations in a separate text editor, where you may use spelling and grammar-checking software. Once you've double-checked your translation, you may come back to Superalgos to replace each paragraph with the translated version.", - "updated": 1613825640442 + "updated": 1613825640442, + "translations": [ + { + "language": "ES", + "text": "Puede encontrar más fácil escribir su traducción en un editor de texto separado, donde puede utilizar corrector ortográfico y gramatical. Ona vez que haya doble chequeado su traducción, puede volver a Superalgos para reemplazar cada parrafo con la versión traducida.", + "updated": 1633278119180 + } + ] }, { "style": "List", "text": "Remember that translations exist at the level of each paragraph. Always make sure that the translation you input matches the correct paragraph. This is important because if a paragraph is updated in the English version, all translations will get a notice that the particular paragraph may be outdated.", - "updated": 1613824142107 + "updated": 1613824142107, + "translations": [ + { + "language": "ES", + "text": "Recuerde que las traducciones existen al nivel de cada párrafo. Siempre asegúrese de que la traducción que introduzca corresponda con el párrafo adecuado. TEsto es impotante porque si el pàrrafo es actualizado en la versión en Inglés, todas las traducciones recibirán un aviso de que ese parrafo en particular puede necesitar actualización.", + "updated": 1633278353289 + } + ] }, { "style": "List", "text": "Participate in the Superalgos Docs Group. Let people know what part of the Docs or which Tutorial you will be working with. This basic coordination will help avoid conflicts when more than one user works on the same pages at the same time.", - "updated": 1616762526615 + "updated": 1616762526615, + "translations": [ + { + "language": "ES", + "text": "Participe en Superalgos Docs Group ( grupo de documentos de superalgos). Permita que la gente sepa que parte de los documentos o que tutoriales va a estar trabajando. Esto coordinación básica ayudará a evitar conflictos cuando más de un usuario trabajan en la misma página al mismo tiempo.", + "updated": 1633278524671 + } + ] }, { "style": "Success", "text": "You may start with the translation of the Docs in [Language] page that you land on after you switch the language.", - "updated": 1613823805871 + "updated": 1613823805871, + "translations": [ + { + "language": "ES", + "text": "Puede comenzar con la traducción de los documentos de la pagina [Language] (idioma) que abra luego de cambiar el idioma.", + "updated": 1633278662035 + } + ] }, { "style": "Title", "text": "Translating Tutorials", - "updated": 1613823828960 + "updated": 1613823828960, + "translations": [ + { + "language": "ES", + "text": "Translating Tutorials Traduciendo tutoriales", + "updated": 1633278676243 + } + ] }, { "style": "Text", "text": "Tutorial pages present certain challenges that we must take into account while translating: the first and foremost is that the space available in the tutorial window is limited. This means that you have to be mindful of the length of the translated text and that you must test each of the tutorial steps to make sure the translation fits the available space.", - "updated": 1613825681579 + "updated": 1613825681579, + "translations": [ + { + "language": "ES", + "text": "Las páginas de los Tutorial presentan ciertos desafíos que debemos tener en cuenta mientras traducimos: el primero y principal es que el espacio disponible en la ventana del tutorial es limitado. Esto significa que debe considerar la extensión del texto traducido y que debe probar cada paso del tutorial para asegurarse que la traducción cabe en el espacio disponible.", + "updated": 1633279006183 + } + ] }, { "style": "Text", "text": "You will notice that if you open the Docs when a tutorial is running, the Docs automatically load the page of the corresponding tutorial step, so that you may edit it. This is quite helpful, as you may translate the page and see how it looks on the tutorial window in real-time.", - "updated": 1613825697215 + "updated": 1613825697215, + "translations": [ + { + "language": "ES", + "text": "Notará que si abre los documentos mientras el tutorial está corriendo, los documentos automáticamente carga l página correspondiente al paso del tutorial, entonces puede editarlo. Esto es de gran ayuda, ya que podrá traducir la página y ver como se ve en la ventanta del tutorial al mismo tiempo.", + "updated": 1633279236805 + } + ] }, { "style": "Important", "text": "However, this is not always the case. Some tutorial steps are configured to close the Docs or the editor, and when you open the Docs manually, the tutorial step page is not loaded automatically. In such cases, you must search for the name of the page — which should match the title of the tutorial step — so that you may access the page manually.", - "updated": 1613825460620 + "updated": 1613825460620, + "translations": [ + { + "language": "ES", + "text": "De todos modos, este no es siempre el caso. Algunos pasos de los tutoriales están configurados para cerrar los dcumentos o el editor, y cuando abre los documentos manualmente, la página del paso del tutorial no se carga automáticamente. En estos casos, deberá buscar la pagina por su nombre — la cual debería coincidir con el titulo del paso en el tutorial — podrá acceder a la página en forma manual.", + "updated": 1633279497908 + } + ] } ] } \ No newline at end of file diff --git a/Projects/Foundations/Schemas/Docs-Topics/T/Tested/Tested-Exchanges/tested-exchanges-001-community-effort-to-test-exchanges.json b/Projects/Foundations/Schemas/Docs-Topics/T/Tested/Tested-Exchanges/tested-exchanges-001-community-effort-to-test-exchanges.json index a8b7f61c1..f955098c4 100644 --- a/Projects/Foundations/Schemas/Docs-Topics/T/Tested/Tested-Exchanges/tested-exchanges-001-community-effort-to-test-exchanges.json +++ b/Projects/Foundations/Schemas/Docs-Topics/T/Tested/Tested-Exchanges/tested-exchanges-001-community-effort-to-test-exchanges.json @@ -4,7 +4,14 @@ "type": "Community Effort to Test Exchanges", "definition": { "text": "This topic covers the results of the Community work testing exchanges. Each page in the topic describes the results of the tests performed on one exchange, and explains whether the exchange is usable or not.", - "updated": 1616010652806 + "updated": 1616010652806, + "translations": [ + { + "language": "ES", + "text": "Este tópico cubre los resultados de los trabajos de testeo de la comunidad en los exchanges. Cada página en el tópico describe el resultados de los testeos realizados en un exchange, y explica si el exchange es utilizable o no.", + "updated": 1633284067216 + } + ] }, "paragraphs": [ { @@ -14,12 +21,26 @@ }, { "style": "Text", - "text": "Superalgos uses the CCXT library to communicate with exchanges. CCXT is an open-source project attempting to standardize access to exchanges APIs." + "text": "Superalgos uses the CCXT library to communicate with exchanges. CCXT is an open-source project attempting to standardize access to exchanges APIs.", + "translations": [ + { + "language": "ES", + "text": "Superalgos utiliza el CCXT library para comunicarse con los exchanges. CCXT es proyecto de código abierto que intenta estandarizar el acceso a las APIs de los exchanges .", + "updated": 1633284193717 + } + ] }, { "style": "Text", "text": "The project lists more than 120 exchanges as \"supported\" and a few dozen exchanges as \"certified\". See the list in the following ink:", - "updated": 1616006648441 + "updated": 1616006648441, + "translations": [ + { + "language": "ES", + "text": "El proyecto lista más de 120 exchanges as \"supported\" and a few dozen exchanges as \"certified\". See the list in the following ink:", + "updated": 1633284228947 + } + ] }, { "style": "Link", @@ -29,12 +50,26 @@ { "style": "Text", "text": "However, it is not clear what exactly is supported nor what is certified. Current experience shows that standardization has still a long way to go.", - "updated": 1616006593509 + "updated": 1616006593509, + "translations": [ + { + "language": "ES", + "text": "De todos modos, no está muy claro exactamente cuales están respaldados y cuales certificados. Experiencias actuales muestran que la estandarización todavía tiene un largo recorrido por delante.", + "updated": 1633284466832 + } + ] }, { "style": "Success", "text": "To know if your preferred exchange is ready to be used in Superalgos, consult the corresponding page in this topic.", - "updated": 1616006719622 + "updated": 1616006719622, + "translations": [ + { + "language": "ES", + "text": "Para saber si su exchange preferido está listo para ser utiliado por Superalgos, consulte la página correspondiente a este tópico.", + "updated": 1633284553628 + } + ] }, { "style": "Title", @@ -44,11 +79,25 @@ { "style": "Text", "text": "If your preferred exchange doesn't show up in this list, it means that it hasn't been tested. You may want to ask in the Develop Group to see if anyone has started tests. ", - "updated": 1616154716371 + "updated": 1616154716371, + "translations": [ + { + "language": "ES", + "text": "Si tu exchange preferido no está incluído en este listado, significa que no ha sido probado. Puede querer preguntar en el Develop Group si alguien ha comenzado con el testeo.", + "updated": 1633284684470 + } + ] }, { "style": "Success", - "text": "If you are a developer, you may want to learn How to Test New Exchanges and help the Community in the quest to expand the list." + "text": "If you are a developer, you may want to learn How to Test New Exchanges and help the Community in the quest to expand the list.", + "translations": [ + { + "language": "ES", + "text": "Si eres un developer, puedes querer aprender How to Test New Exchanges y ayudar a la comunidad en la búsqueda de expandir el listado.", + "updated": 1633284798025 + } + ] } ] } \ No newline at end of file diff --git a/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-043-tutorial-step-placing-plugins.json b/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-043-tutorial-step-placing-plugins.json index e86ba0b8c..66410b618 100644 --- a/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-043-tutorial-step-placing-plugins.json +++ b/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-043-tutorial-step-placing-plugins.json @@ -57,8 +57,8 @@ }, { "language": "ES", - "text": "Nuevos nodos Plugin File se crean para cada plugin in \\Plugins\\Trading-Systems. Puede eliminar los nodos Plugin File no necesitas y conserva los que necesites! Luego, puedes agregar y anclar el nodo Plugin File Position donde deseas colocar el plugin.", - "updated": 1626643680169, + "text": "Nuevos nodos Plugin File se crean para cada plugin in \\Foundations\\Plugins\\Trading-Systems. Puede eliminar los nodos Plugin File que no necesita y conservar los que necesite! Luego, puedes agregar y anclar el nodo Plugin File Position donde deseas colocar la jerarquía del plugin. ", + "updated": 1633282144023, "style": "Text" } ] diff --git a/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-044-tutorial-step-non-persistence-of-changes.json b/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-044-tutorial-step-non-persistence-of-changes.json index cc90cb9cb..190cf1784 100644 --- a/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-044-tutorial-step-non-persistence-of-changes.json +++ b/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-044-tutorial-step-non-persistence-of-changes.json @@ -38,8 +38,8 @@ }, { "language": "ES", - "text": "Hierarchies incluidos en el workspace, ya que los plugins no se guardan en el nivel del workspace. Como tal, los cambios realizados en esas jerarquías no persisten. Si deseas modificar un plugin y seguir trabajando con la versión modificada en el futuro, debes clonar o hacer una copia de seguridad del plugin y trabajar en la copia resultante.", - "updated": 1626702533816, + "text": "Las Hierarchies (Jerarquías) colocadas en el workspace como plugins (copias) no se guardan en el workspace por defecto. Como resultado, los cambios realizados en esas jerarquías no persiten, a menos que las salve en forma manual o habilite el guardado automático. ", + "updated": 1633282516205, "style": "Warning" } ] @@ -57,8 +57,8 @@ }, { "language": "ES", - "text": "¡Pasaré por algunos casos de uso específicos en los próximos pasos!", - "updated": 1626702765005, + "text": "Hay dos casos principales para modificar los plugins:", + "updated": 1633282630926, "style": "Text" } ] @@ -66,11 +66,25 @@ { "style": "List", "text": "You wish to modify a plugin to make it your own and keep working with the modified version in the future.", - "updated": 1629897838348 + "updated": 1629897838348, + "translations": [ + { + "language": "ES", + "text": "Desea modificar un plugin para hacer uno propio y continuar trabajando con la versión modificada en el futuro.", + "updated": 1633282732027 + } + ] }, { "style": "List", - "text": "You wish to update and improve a plugin to contribute the improvements to the project." + "text": "You wish to update and improve a plugin to contribute the improvements to the project.", + "translations": [ + { + "language": "ES", + "text": "Desea actualizar y mejorar un plugin para contribuir en el mejoramiento del proyecto.", + "updated": 1633282817838 + } + ] } ] } \ No newline at end of file diff --git a/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-046-tutorial-step-starting-from-a-plugin.json b/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-046-tutorial-step-starting-from-a-plugin.json index 04eeef2a6..559d1f7dd 100644 --- a/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-046-tutorial-step-starting-from-a-plugin.json +++ b/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-046-tutorial-step-starting-from-a-plugin.json @@ -18,8 +18,8 @@ }, { "language": "ES", - "text": "Un caso típico es cuando desea introducir cambios en una estrategia de envío con el sistema para comenzar con una configuración probada.", - "updated": 1626702894193, + "text": "Miremos el primer escenario: un caso típico es cuando desea introducir cambios a una estrategia incluída en el sistema para comenzar con una configuración probada.", + "updated": 1633283150203, "style": "Definition" } ] @@ -38,8 +38,8 @@ }, { "language": "ES", - "text": "Digamos que recién estás comenzando con Superalgos, has hecho algunos tutoriales y estás listo para comenzar a jugar con una estrategia. Deseas comenzar con una estrategia existente e introducir modificaciones menores para comprender mejor cómo funcionan las cosas. La estrategia en cuestión se incluye como plugin en un workspace específico.", - "updated": 1626703032336, + "text": "Digamos que está listo para comenzar a jugar con una estrategia.. Quiere comenzar con una existente o introducir modificaciones para entender como trabajan las cosas. No tiene intensiones de contribuir con los cambios. Solo desea jugar con esto y cambiarlo a su gusto! Entonces, haga lo siguiente:", + "updated": 1633283766269, "style": "Text" } ] @@ -57,8 +57,8 @@ }, { "language": "ES", - "text": "En tales casos, debes eliminar el nodo Plugin File correspondiente a el Trading System y restaurar el archivo original en la carpeta \\Plugins\\Trading-Systems como si fuera un backup: arrastra el archivo y suéltalo en el Design Space!", - "updated": 1626703323868, + "text": "Borre el nodo Plugin File correspondiente al Trading System y restablezca el plugin file original en (\\Plugins\\Trading-Systems folder) como si fuera un a backup: arrastre el archivo y suéltelo en el Design Space! La estrategia ahora vive en el workspace y puede modificarlo y grabarlo.", + "updated": 1633283708150, "style": "Success" } ] diff --git a/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-047-tutorial-step-improving-a-plugin.json b/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-047-tutorial-step-improving-a-plugin.json index 730af6bbc..06b59af30 100644 --- a/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-047-tutorial-step-improving-a-plugin.json +++ b/Projects/Foundations/Schemas/Docs-Tutorials/B/Basic/Basic-Education/basic-education-047-tutorial-step-improving-a-plugin.json @@ -5,7 +5,7 @@ "definition": { "text": "About the second scenario: let's say you are testing the EMA indicator, found a bug and know how to fix it. You intend to contribute the fix so that everyone benefits from it!", "icon": { - "name": "sensor-bot", + "name": "indicator-bot", "project": "Foundations" }, "updated": 1629909327051, From e43f3aac01e81dca46fee224c69f7e172c3f76a4 Mon Sep 17 00:00:00 2001 From: EvaMaria70 Date: Sun, 3 Oct 2021 23:28:44 +0200 Subject: [PATCH 3/8] This is my contribution to Superalgos --- ...o-002-establish-and-remove-references.json | 90 ++++++++++++++++--- 1 file changed, 80 insertions(+), 10 deletions(-) diff --git a/Projects/Foundations/Schemas/Docs-Topics/H/How/How-To/how-to-002-establish-and-remove-references.json b/Projects/Foundations/Schemas/Docs-Topics/H/How/How-To/how-to-002-establish-and-remove-references.json index 5055aecdb..3931af158 100644 --- a/Projects/Foundations/Schemas/Docs-Topics/H/How/How-To/how-to-002-establish-and-remove-references.json +++ b/Projects/Foundations/Schemas/Docs-Topics/H/How/How-To/how-to-002-establish-and-remove-references.json @@ -4,7 +4,14 @@ "type": "Establish and Remove References", "definition": { "text": "To establish a reference, right-click on the first node and drag it close to the target node. The remove a reference, use the delink button on the menu.", - "updated": 1609949247846 + "updated": 1609949247846, + "translations": [ + { + "language": "ES", + "text": "Para establecer la referencia, click derecho en el primer nodo y arrástrelo cerca del nodo de destino. Entonces remueva la referencia, use el boton delink en el menú.", + "updated": 1633296472626 + } + ] }, "paragraphs": [ { @@ -14,7 +21,14 @@ }, { "style": "Text", - "text": "When establishing a reference, grey rings show which nodes you may establish the reference with. In case there are multiple nodes that would accept the reference, the one closer to the node where the reference originates is highlighted with a golden ring. Releasing the mouse button establishes the reference with the highlighted node." + "text": "When establishing a reference, grey rings show which nodes you may establish the reference with. In case there are multiple nodes that would accept the reference, the one closer to the node where the reference originates is highlighted with a golden ring. Releasing the mouse button establishes the reference with the highlighted node.", + "translations": [ + { + "language": "ES", + "text": "Cuando esteé estableciendo una referencia, anilos grises muestran con cuales nodos puede establecer la referencia. En caso de que haya muchos nodos que aceptarían la referencia, el nodo que esté más cerca de donde se origina la referencia está destacado con un anillo dorado. Liberando el botón del mouse establece a referencia con el nodo destacado.", + "updated": 1633296500174 + } + ] }, { "style": "Gif", @@ -23,12 +37,26 @@ }, { "style": "Text", - "text": "The reference is visually represented by a faint grey dotted line. Such line is visible only when both ends of the reference are visible." + "text": "The reference is visually represented by a faint grey dotted line. Such line is visible only when both ends of the reference are visible.", + "translations": [ + { + "language": "ES", + "text": "La referencia es visualmente representada por una leve linea de puntos grises. Esta linea es vicible solo cuando ambos extremos de la referencia son visibles.", + "updated": 1633295706095 + } + ] }, { "style": "Text", "text": "To remove a reference or delink two nodes, use the delink button on the node where the reference originates.", - "updated": 1609949517565 + "updated": 1609949517565, + "translations": [ + { + "language": "ES", + "text": "Para remover una referencia o deslinkear dos nodos, use el botón delink button del nodo dondela referencia se origina.", + "updated": 1633295798732 + } + ] }, { "style": "Anchor", @@ -46,7 +74,14 @@ { "style": "Text", "text": "The process is exactly the same. All you need to do is master a few tricks so that you may drag one of the nodes all the way to where the second node is.", - "updated": 1611940896508 + "updated": 1611940896508, + "translations": [ + { + "language": "ES", + "text": "El proceso es exactamente el mismo. Todo lo que necesita es manejar unos pocos trucos para que pueda arrastrar uno de los nodos todo el recorrido hasta donde el segundo nodo está.", + "updated": 1633295934654 + } + ] }, { "style": "Youtube", @@ -56,24 +91,59 @@ { "style": "Text", "text": "These UI tricks may make your life easier:", - "updated": 1611940968078 + "updated": 1611940968078, + "translations": [ + { + "language": "ES", + "text": "Estos UI trucos pueden hacer tu vida más fácil:", + "updated": 1633295979755 + } + ] }, { "style": "List", "text": "Use the design space map as many times as required to find your way from one hierarchy to the other.", - "updated": 1611940996169 + "updated": 1611940996169, + "translations": [ + { + "language": "ES", + "text": "Use el design space map tantas veces como sea necesario para encontrar el camino desde una jeraquía a la otra.", + "updated": 1633296062866 + } + ] }, { "style": "List", - "text": "Pin the node you are going to move across the design space, so that you may drop it at any point to check the design space map for directions." + "text": "Pin the node you are going to move across the design space, so that you may drop it at any point to check the design space map for directions.", + "translations": [ + { + "language": "ES", + "text": "Fije el nodo que va a mover a través del espacio de diseño, para que pueda soltarlo en cualquier punto para chequear las direcciones en el mapa del espacio de diseño.", + "updated": 1633296213030 + } + ] }, { "style": "List", - "text": "Use Ctrl / Command + arrow keys to drag the node across the screen after clicking on it with the mouse. Keep keys pressed and the node flies!" + "text": "Use Ctrl / Command + arrow keys to drag the node across the screen after clicking on it with the mouse. Keep keys pressed and the node flies!", + "translations": [ + { + "language": "ES", + "text": "Use Ctrl / Command + arteclas de flechas para arrastrar el nodo a través dela pantalla despues de clickear en el con el mouse. Mantenga las teclas presionadas y el nodo vuela!", + "updated": 1633296325908 + } + ] }, { "style": "List", - "text": "Remove the pin once the reference is established so that the node goes back to its place." + "text": "Remove the pin once the reference is established so that the node goes back to its place.", + "translations": [ + { + "language": "ES", + "text": "Remueva el ijado ona vez que la referencia sea establecida para que el nodo vuelva a su lugar.", + "updated": 1633296417854 + } + ] } ] } \ No newline at end of file From fc3419e2c1cf9460cba042ea675d777140d408d6 Mon Sep 17 00:00:00 2001 From: EvaMaria70 Date: Sun, 3 Oct 2021 23:39:45 +0200 Subject: [PATCH 4/8] This is my contribution to Superalgos --- ...al-036-tutorial-step-tokens-dont-move.json | 27 ++++++++++++++++--- 1 file changed, 24 insertions(+), 3 deletions(-) diff --git a/Projects/Governance/Schemas/Docs-Tutorials/C/Creating/Creating-Your-User-Profile-Tutorial/creating-your-user-profile-tutorial-036-tutorial-step-tokens-dont-move.json b/Projects/Governance/Schemas/Docs-Tutorials/C/Creating/Creating-Your-User-Profile-Tutorial/creating-your-user-profile-tutorial-036-tutorial-step-tokens-dont-move.json index dfa209cb2..0c21aa04f 100644 --- a/Projects/Governance/Schemas/Docs-Tutorials/C/Creating/Creating-Your-User-Profile-Tutorial/creating-your-user-profile-tutorial-036-tutorial-step-tokens-dont-move.json +++ b/Projects/Governance/Schemas/Docs-Tutorials/C/Creating/Creating-Your-User-Profile-Tutorial/creating-your-user-profile-tutorial-036-tutorial-step-tokens-dont-move.json @@ -8,18 +8,39 @@ "icon": { "name": "stop", "project": "Foundations" - } + }, + "translations": [ + { + "language": "ES", + "text": "Cuando decimos Token Power Flows, es importante aclarar que los tokens no van a ninguna parte! Es el Token Power el que fluye!", + "updated": 1633296750160 + } + ] }, "paragraphs": [ { "style": "Important", "text": "Tokens in your Governance Address never leave your address! There is zero cost for participating in governance! The balance in your address confers Token Power to your User Profile, and it is this abstraction that flows down the hierarchy, not actual tokens.", - "updated": 1630929379130 + "updated": 1630929379130, + "translations": [ + { + "language": "ES", + "text": "Tokens en su Governance Address nunca se van de su dirección! Hay cero costo por participar en la gobernancia! El balance en su dirección le confiere Token Power a su User Profile, y es esta abstracción lo que fluye hacia abajo en la jerarquia, no tokens reales.", + "updated": 1633297162024 + } + ] }, { "style": "Callout", "text": "Remind me to show you how to play with Token Power Flows before we wrap up the tutorial! But let's get back to Community Building Programs before we lose our way!", - "updated": 1630933419243 + "updated": 1630933419243, + "translations": [ + { + "language": "ES", + "text": "Recuérdame que te muestre icomo jugar con Token Power Flows antes de que embalemos el tutorial! Pero regresemos a Community Building Programs antes de que perdamos el rumbo!", + "updated": 1633296908255 + } + ] } ] } \ No newline at end of file From fed1b8d0ec9e8b5cdbf9cf3d52fa6980255dab7f Mon Sep 17 00:00:00 2001 From: EvaMaria70 Date: Sun, 3 Oct 2021 23:57:22 +0200 Subject: [PATCH 5/8] This is my contribution to Superalgos --- ...-044-tutorial-step-playing-with-flows.json | 54 ++++++++++++++++--- 1 file changed, 48 insertions(+), 6 deletions(-) diff --git a/Projects/Governance/Schemas/Docs-Tutorials/C/Creating/Creating-Your-User-Profile-Tutorial/creating-your-user-profile-tutorial-044-tutorial-step-playing-with-flows.json b/Projects/Governance/Schemas/Docs-Tutorials/C/Creating/Creating-Your-User-Profile-Tutorial/creating-your-user-profile-tutorial-044-tutorial-step-playing-with-flows.json index 6af3e3190..2c7c26c3f 100644 --- a/Projects/Governance/Schemas/Docs-Tutorials/C/Creating/Creating-Your-User-Profile-Tutorial/creating-your-user-profile-tutorial-044-tutorial-step-playing-with-flows.json +++ b/Projects/Governance/Schemas/Docs-Tutorials/C/Creating/Creating-Your-User-Profile-Tutorial/creating-your-user-profile-tutorial-044-tutorial-step-playing-with-flows.json @@ -8,31 +8,73 @@ "icon": { "name": "Programs//delegation-program", "project": "Governance" - } + }, + "translations": [ + { + "language": "ES", + "text": "Casi me olvido! Antes de que se vaya, Voy a darle un curso intensivo para que pueda jugar un poco con algo de Token Power real!", + "updated": 1633297571727 + } + ] }, "paragraphs": [ { "style": "Text", "text": "We're sneaking into the lead developer's User Profile, particularly in his Delegation Program! Your mission: delegate yourself some Token Power so that you can play with the flows within your own profile!", - "updated": 1630931293437 + "updated": 1630931293437, + "translations": [ + { + "language": "ES", + "text": "Estamos espiando en el User Profile del leader de develop, particularlmente en su Delegation Program! la misión: deleguese a si mismo algo de Token Power para que pueda jugar con el flujo dentro de su propio perfil!", + "updated": 1633297853468 + } + ] }, { "style": "Callout", - "text": "Use the User Delegate node on the right to reference your own User Profile!" + "text": "Use the User Delegate node on the right to reference your own User Profile!", + "translations": [ + { + "language": "ES", + "text": "Use el nodo de User Delegate a la derecha para referenciar a su propio User Profile!", + "updated": 1633298180980 + } + ] }, { "style": "List", "text": "You can freely play with other User Profiles.", - "updated": 1630931454654 + "updated": 1630931454654, + "translations": [ + { + "language": "ES", + "text": "Puede libremente jugar con otros User Profiles.", + "updated": 1633297955207 + } + ] }, { "style": "List", "text": "Those profiles don't save with the workspace.", - "updated": 1630931469032 + "updated": 1630931469032, + "translations": [ + { + "language": "ES", + "text": "Esos profiles no se graban en el workspace.", + "updated": 1633298215317 + } + ] }, { "style": "List", - "text": "Even if you submitted them to the repo, they would be rejected by our bot controlling that profiles are uploaded by their owners only." + "text": "Even if you submitted them to the repo, they would be rejected by our bot controlling that profiles are uploaded by their owners only.", + "translations": [ + { + "language": "ES", + "text": "Aunque los someta al repositorio, serían rechazados por nuestro bot controlando que profiles son actualizados por sus dueños unicamente.", + "updated": 1633298152744 + } + ] } ] } \ No newline at end of file From 823c920baf46f90fe993869d3a76448d0398fb27 Mon Sep 17 00:00:00 2001 From: EvaMaria70 Date: Mon, 4 Oct 2021 13:54:04 +0200 Subject: [PATCH 6/8] This is my contribution to Superalgos --- .../Docs-Books/the-governance-project.json | 9 +- ...to-governance-001-governance-overview.json | 171 ++++++++++++++++-- 2 files changed, 160 insertions(+), 20 deletions(-) diff --git a/Projects/Governance/Schemas/Docs-Books/the-governance-project.json b/Projects/Governance/Schemas/Docs-Books/the-governance-project.json index eeb98ace4..3a7be216e 100644 --- a/Projects/Governance/Schemas/Docs-Books/the-governance-project.json +++ b/Projects/Governance/Schemas/Docs-Books/the-governance-project.json @@ -2,7 +2,14 @@ "type": "The Governance Project", "definition": { "text": "The Governance Project is designed as a flexible system that allows the Community to dynamically direct influence in arbitrary directions. It allows governance to evolve with the project. It also encourages permissionless innovation, as Contributors may propose new areas of development and rally the Community to incentivize expansion along new lines.", - "updated": 1624782493205 + "updated": 1624782493205, + "translations": [ + { + "language": "ES", + "text": "El proyecto de gobernanza está diseñado como un sistema flexible que permite a la comunidad dirigir influencias en direcciones arbitrarias en forma dinámica. Esto permite que la gobernanza evolucione con el proyecto. También promueve la innovación sin permiso, ya que los contribuyentes pueden proponer nuevas áreas de desarrollo y movilizar a la comunidad a incentivar la expansión a lo largo de nuevas lineas.", + "updated": 1633344584790 + } + ] }, "paragraphs": [ { diff --git a/Projects/Governance/Schemas/Docs-Topics/I/Introduction/Introduction-to-Governance/introduction-to-governance-001-governance-overview.json b/Projects/Governance/Schemas/Docs-Topics/I/Introduction/Introduction-to-Governance/introduction-to-governance-001-governance-overview.json index dd916b1ad..765df4065 100644 --- a/Projects/Governance/Schemas/Docs-Topics/I/Introduction/Introduction-to-Governance/introduction-to-governance-001-governance-overview.json +++ b/Projects/Governance/Schemas/Docs-Topics/I/Introduction/Introduction-to-Governance/introduction-to-governance-001-governance-overview.json @@ -4,37 +4,93 @@ "type": "Governance Overview", "definition": { "text": "Governance of the Superalgos Project is distributed among all members of the Community willing to participate. You may engage in multiple manners, help drive development in the desired directions, and contribute to nurturing a healthy community.", - "updated": 1630424148804 + "updated": 1630424148804, + "translations": [ + { + "language": "ES", + "text": "La gobernanza del proyecto de Superalgos está distribuída entre todos los miembros de la comunidad que estén dispuestos a participar. Puede comprometerse de múltiples maneras, ayudar a dirigir el desarrollo en las direcciones deseadas, y contribuir a nutrir una comunidad saludable.", + "updated": 1633345029161 + } + ] }, "paragraphs": [ { "style": "Text", "text": "To participate in governance, community members leverage their Superalgos SA Token holdings, exerting influence proportional to their Token Power and their Reputation. The combined influence of all token holders participating in governance determines, among other things:", - "updated": 1630065456504 + "updated": 1630065456504, + "translations": [ + { + "language": "ES", + "text": "Para participar en la gobernanza, los miembros de la comunidad apalancan su tenencia de Superalgos SA Token, ejerciendo influencia proporcional a su Token Power y a su Reputation. La inlfuencia combinada de todos los tenedores de token que participan en la gobernancia determinan, entre otras cosas:", + "updated": 1633345582953 + } + ] }, { "style": "List", - "text": "What Positions, Features, Assets, or project-development activities, in general, are incentivized and how." + "text": "What Positions, Features, Assets, or project-development activities, in general, are incentivized and how.", + "translations": [ + { + "language": "ES", + "text": "Que Positions, Features, Assets, o actividades de desarrollo de proyectos, en general, están incentivados y cómo.", + "updated": 1633348402852 + } + ] }, { "style": "List", - "text": "Which Contributors are compensated for which Contributions." + "text": "Which Contributors are compensated for which Contributions.", + "translations": [ + { + "language": "ES", + "text": "Que contribuyentes son pagados por cuales contribuciones.", + "updated": 1633345751024 + } + ] }, { "style": "List", - "text": "What Programs are funded and how." + "text": "What Programs are funded and how.", + "translations": [ + { + "language": "ES", + "text": "Qué programas se financian y cómo", + "updated": 1633345784026 + } + ] }, { "style": "Text", - "text": "You may exert your influence dynamically, as you may redirect your Token Power at any moment. The distribution of Token Power upon each release of the software — tied to the corresponding Superalgos SA Token Distribution Event — determines how tokens allocated to the release are distributed." + "text": "You may exert your influence dynamically, as you may redirect your Token Power at any moment. The distribution of Token Power upon each release of the software — tied to the corresponding Superalgos SA Token Distribution Event — determines how tokens allocated to the release are distributed.", + "translations": [ + { + "language": "ES", + "text": "Puede ejercer su influencia de forma dinámica, ya que puede redirigir su Token Power en cualquier momento. La distribución de Token Power en cada lanzamiento del software — atado al correspondiente Superalgos SA Token Distribution Event — determina cómo se distribuyen los tokens asignados al lanzamiento.", + "updated": 1633345986132 + } + ] }, { "style": "Text", - "text": "The Governance Project is designed as a flexible system that allows the Community to dynamically direct influence in arbitrary directions. It allows governance to evolve with the project. It also encourages permissionless innovation, as Contributors may propose new areas of development and rally the Community to incentivize expansion along new lines." + "text": "The Governance Project is designed as a flexible system that allows the Community to dynamically direct influence in arbitrary directions. It allows governance to evolve with the project. It also encourages permissionless innovation, as Contributors may propose new areas of development and rally the Community to incentivize expansion along new lines.", + "translations": [ + { + "language": "ES", + "text": "El Governance Project está diseñado como un sistema flexible que permite a la comunidad ejercer influencia en direcciones arbitrarias de manera dinámica. Permite que la gobernanza evolucione con el proyecto. también promueve la innovación sin permiso, ya que los Colaboradores pueden proponer nuevas áreas de desarrollo y conducir a la comunidad incentivar expansion a lo largo de lineas nuevas.", + "updated": 1633346387045 + } + ] }, { "style": "Note", - "text": "A Community engaged in governance is crucial for the development of the project, therefore participation is incentivized. In other words, you will earn Superalgos SA Tokens if you take part in the governance of Superalgos." + "text": "A Community engaged in governance is crucial for the development of the project, therefore participation is incentivized. In other words, you will earn Superalgos SA Tokens if you take part in the governance of Superalgos.", + "translations": [ + { + "language": "ES", + "text": "Una comunidad comprometida con la gobernanza es fundamental para el desarrollo del proyecto, por lo tanto se incentiva la participación, en otras palabras, ganará Superalgos SA Tokens si forma parte de la gobernanza de Superalgos.", + "updated": 1633346519203 + } + ] }, { "style": "Title", @@ -42,31 +98,73 @@ }, { "style": "Text", - "text": "The governance system is implemented within Superalgos as the Governance Project, making use of the same visual scripting resources, hierarchical data structures, and concepts such as References that make up the Superalgos paradigm you are familiar with." + "text": "The governance system is implemented within Superalgos as the Governance Project, making use of the same visual scripting resources, hierarchical data structures, and concepts such as References that make up the Superalgos paradigm you are familiar with.", + "translations": [ + { + "language": "ES", + "text": "El sistema de gobernanza se implementa con Superalgos, haciendo uso de los mismos recursos de secuencias de comandos visuale, estructuras de datos jerárquicos, y conceptos tales como referencias que conforman el paradigma de Superalgos con el que está familiarizado.", + "updated": 1633346787559 + } + ] }, { "style": "Text", - "text": "As such, governance does not require the use of smart contracts to enforce immutable rules. On the contrary, in Superalgos, governance is an ever-evolving notion, pretty much like the rest of the project." + "text": "As such, governance does not require the use of smart contracts to enforce immutable rules. On the contrary, in Superalgos, governance is an ever-evolving notion, pretty much like the rest of the project.", + "translations": [ + { + "language": "ES", + "text": "Como tal, la gobernanza no requiere el uso de contratos inteligentes para hacer cumplir reglas inmutables. Por el contrario, en Superalgos, la gobernanza es una noción en constante evolución, muy parecida al resto del proyecto. ", + "updated": 1633346878247 + } + ] }, { "style": "Callout", "text": "This flexibility is a crucial feature that will allow us to evolve the governance system, adapt the game theory behind it, and correct any exploits that bad actors may find over time.", - "updated": 1630424896773 + "updated": 1630424896773, + "translations": [ + { + "language": "ES", + "text": "Esta flexibilidad es una característica crucial que nos permitirá hacer evolucionar el sistema de gobernanza, adaptar la teoría del juego detrás de él y corregir cualquier vulnerabilidad que los malos actores puedan encontrar con el tiempo", + "updated": 1633346945113 + } + ] }, { "style": "Text", "text": "Governance is defined across multiple Governance Workspaces that users may load and contribute to. These workspaces feature the definitions of several hierarchies that determine the relationship of all the concepts affecting governance.", - "updated": 1630424913354 + "updated": 1630424913354, + "translations": [ + { + "language": "ES", + "text": "La gobernanza está definida a través de múltiples Governance Workspaces que los usuarios pueden cargar y contribuir con. Estos espacios de trabajo presentan las definiciones de varias jerarquías que determinan la relación de todos los conceptos que afectan la gobernanza.", + "updated": 1633347120583 + } + ] }, { "style": "Text", "text": "To participate in governance, users must set up and submit a User Profile plugin defining how they intend to exert the influence conferred by their Superalgos SA Token holdings. The influence and participation is defined through different types of programs, votes, and claims.", - "updated": 1629992750219 + "updated": 1629992750219, + "translations": [ + { + "language": "ES", + "text": "Para participar en la gobernanaza, los usuarios deben configurar y enviar un User Profile plugin que define cómo pretenden ejercer la influencia conferida por sus tenencias de Superalgos SA Token. La inlfuencia y participación está definida mediante diferentes tipos de programas, votos y declaraciones.", + "updated": 1633347353982 + } + ] }, { "style": "Text", "text": "The Governance System computes votes and claims in realtime, showing a preview of what the distribution may look like, on the UI.", - "updated": 1630425053320 + "updated": 1630425053320, + "translations": [ + { + "language": "ES", + "text": "El sistema de gobernanza computa los votos y las declaraciones en tiempo real, mostrando una vista previa de lo que la distribucion showing a preview of what the distribution puede parecer, en el UI.", + "updated": 1633347466937 + } + ] }, { "style": "Include", @@ -83,25 +181,60 @@ }, { "style": "Text", - "text": "Because all definitions affecting governance ship as plugins with the software, the process is transparent and auditable. " + "text": "Because all definitions affecting governance ship as plugins with the software, the process is transparent and auditable. ", + "translations": [ + { + "language": "ES", + "text": "Porque las definiciones que afectan a la gobernanza envia como plugin con el software, el proceso es transparente y auditable.", + "updated": 1633347687363 + } + ] }, { "style": "List", "text": "Any user may, at any point, load the corresponding Plugin Workspaces and visualize how influence is being exerted by all Superalgos SA Token holders participating.", - "updated": 1629995410591 + "updated": 1629995410591, + "translations": [ + { + "language": "ES", + "text": "cualquier usuario puede, en cualquier momento, cargar el correspondiente Plugin Workspaces y visualizar and visualizecómo la influencia está siendo ejercida por todos participantes titulares de Superalgos SA Token..", + "updated": 1633347841894 + } + ] }, { "style": "List", - "text": "Any user may verify all metrics managed by the Governance Project in the tables displayed in the Governace Tab." + "text": "Any user may verify all metrics managed by the Governance Project in the tables displayed in the Governace Tab.", + "translations": [ + { + "language": "ES", + "text": "Cualquier usuario puede verificar Any user may verify todas las métricas gestionadas por el Governance Project en las tablas desplegadas en el Governace Tab.", + "updated": 1633347961533 + } + ] }, { "style": "List", - "text": "Any user may run a simulation of the Superalgos SA Token distribution process and verify how tokens allocated to the next release will be distributed." + "text": "Any user may run a simulation of the Superalgos SA Token distribution process and verify how tokens allocated to the next release will be distributed.", + "translations": [ + { + "language": "ES", + "text": "Cualquier usuario puede hacer correr una simulación de el proceso de distribución de Superalgos SA Token y verificar verify cómo se distribuirán los tokens asignados a la próxima versión.", + "updated": 1633348037956 + } + ] }, { "style": "List", "text": "Any user may obtain (from GitHub) and load historical versions of the software, and run a simulation of the Superalgos SA Token Distribution Event to verify how tokens were distributed in past releases. Notice that, in this case, the absolute number of votes may not be valid as token holdings will have varied; however, any user may validate the relative distribution.", - "updated": 1630425087155 + "updated": 1630425087155, + "translations": [ + { + "language": "ES", + "text": "Cualquier usuario puede obtener (mediante GitHub) y cargar versiones históricas del software, y hacer correr una simulación de Superalgos SA Token Distribution Event para verificar como los tokens han sido distribuidos ten lasnzamientos anteriores. Note quet, en este caso, el número absoluto de votos puede no ser válido ya que las tenencias de token habrán variado, de todas maneras, cualquier usuario puede validar la distribución relativa.", + "updated": 1633348350518 + } + ] } ] } \ No newline at end of file From c445691bc97714e63611582d74f621177447fbbd Mon Sep 17 00:00:00 2001 From: EvaMaria70 Date: Mon, 4 Oct 2021 19:58:03 +0200 Subject: [PATCH 7/8] This is my contribution to Superalgos --- ...algos-006-how-to-contribute-tutorials.json | 270 ++++++++++++++++-- 1 file changed, 240 insertions(+), 30 deletions(-) diff --git a/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-006-how-to-contribute-tutorials.json b/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-006-how-to-contribute-tutorials.json index 3403824af..aaaf88ba4 100644 --- a/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-006-how-to-contribute-tutorials.json +++ b/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-006-how-to-contribute-tutorials.json @@ -4,13 +4,27 @@ "type": "How to Contribute Tutorials", "definition": { "text": "Tutorials are the ultimate educational resource available in Superalgos, and they play a crucial role during the onboarding of new users. Contributing tutorials is a great way to help the project grow the user base and is highly appreciated!", - "updated": 1617710488028 + "updated": 1617710488028, + "translations": [ + { + "language": "ES", + "text": "Los tutoriales son la última fuente educativa disponible en Superalgos, y juegan un papel crucial durante la introducción de los usuarios nuevos. Contribuir con los tutoriales es un excelente modo de ayudar al proyecto para que su base de usuarios crezca y lo apreciamos muchísimo!", + "updated": 1633370243631 + } + ] }, "paragraphs": [ { "style": "Text", "text": "This page discusses best practices to build and contribute Superalgos tutorials. It doesn't cover the actual mechanics of building tutorials. Instead, it focuses on what is desirable.", - "updated": 1617732597782 + "updated": 1617732597782, + "translations": [ + { + "language": "ES", + "text": "Esta página habla a cerca de las mejores prácticas para construir y contribuir tutoriales de Superalgos. No cubre la mecanica actual de construir tutoriales. en lugar de eso está enfocado en lo que sería deseable.", + "updated": 1633364195196 + } + ] }, { "style": "Title", @@ -20,17 +34,38 @@ { "style": "Text", "text": "At Superalgos, we take pride in the quality of the product we are building. Documentation and tutorials are crucial parts of Superalgos.", - "updated": 1617732636344 + "updated": 1617732636344, + "translations": [ + { + "language": "ES", + "text": "En Superalgos, nosotros nos sentimos orgullosos de la cualidad del producto que estamos construyendo. La documentación y los tutoriales son una parte crucial de Superalgos.", + "updated": 1633364296850 + } + ] }, { "style": "Text", "text": "That said, we understand that it takes time and effort to get to a quality product, thus iterating on early prototypes and implementing early-stage feedback is a good way to achieve the desired quality standards.", - "updated": 1617732666027 + "updated": 1617732666027, + "translations": [ + { + "language": "ES", + "text": "Dicho esto, nosotros entendemos que se requiere de tiempo y esfuerzo para obtener un producto de cualidad por lo tanto, iteractuar sobre los primeros prototipos e implementar la retroalimentación en las primeras etapas es una buena manera de lograr el objetivo deseado de los estándares de cualidad.", + "updated": 1633364481390 + } + ] }, { "style": "Success", "text": "When you build a tutorial for Superalgos, you become the maintainer of the tutorial. It is your responsibility to keep the tutorial up to date with the system, and to implement the feedback users may share! Your tutorial must become the ultimate resource to learn the topics it covers. ", - "updated": 1620645983606 + "updated": 1620645983606, + "translations": [ + { + "language": "ES", + "text": "Cuando construye un tutorial para Superalgos, se convierte en quien mantiene el tutorial. Es su reponsabilidad ,mantener el tutorial actualizado con el sistema, e implementar los comentarios que los usuarios pueden compartir! Su tutorial debe convertirse en la fuente fundamental para aprender el tópico con el cual está relacionado.", + "updated": 1633364765692 + } + ] }, { "style": "Title", @@ -40,7 +75,14 @@ { "style": "Text", "text": "To deliver the best possible experience, a tutorial must be featured in a specific Workspace, and the workspace must be custom-tailored to serve the tutorial. The workspace must be clean and feature the assets required for the learning experience to be optimal. It is best to keep the workspace clean, light, and stripped of unnecessary resources.", - "updated": 1617732813825 + "updated": 1617732813825, + "translations": [ + { + "language": "ES", + "text": "Para ofrecer a mejor experiencia posible, un tutorial debe aparecer en un Workspace, específico y el workspace debe ser personalizado para servir al tutorial. El workspace debe ser limpio y segurar los elementos necesarios para que la experiencia de aprendizaje sea óptima- Es lo mejor mantener el workspace limpio, ligero, y despojado de recursos innecesarios.", + "updated": 1633365163709 + } + ] }, { "style": "Subtitle", @@ -50,16 +92,37 @@ { "style": "Text", "text": "If your tutorial deals with data, it is best to use the same exchange, market, and date ranges already in use in the Getting Started Plugin Workspace tutorials. This way, users will already have the data and can go through the tutorial easier.", - "updated": 1621871223112 + "updated": 1621871223112, + "translations": [ + { + "language": "ES", + "text": "Si el tutorial your tutorial trata con datos,es lo mejor utilizar el mismo exchange, market, y rango de datoss, ya en uso en los tutoriales de Getting Started Plugin Workspace. De este modo, los usuarios ya tendran los dtos y pueden ir a través del tutorial con mayor facilidad.", + "updated": 1633365432578 + } + ] }, { "style": "Note", "text": "If for whatever reason the tutorial must deal with other markets and/or exchanges to deliver the content, then go ahead and ignore the above.", - "updated": 1621871324929 + "updated": 1621871324929, + "translations": [ + { + "language": "ES", + "text": "Si por cualquier razón el tutorial debiera tratar con otros mercados y/o exchanges para enviar el contenido, entonces siga adelante e ignore lo de aquí arriba.", + "updated": 1633365546892 + } + ] }, { "style": "Success", - "text": "Make sure you include a step allowing users to switch to BinanceUS, in case they need to, just like in the Welcome to Superalgos Tutorial." + "text": "Make sure you include a step allowing users to switch to BinanceUS, in case they need to, just like in the Welcome to Superalgos Tutorial.", + "translations": [ + { + "language": "ES", + "text": "Asegúrese de incluir un paso permitiendo a los usuarios enlazar con BinanceUS, en caso de que lo necesiten como en el caso del tutorial de Welcome to Superalgos.", + "updated": 1633365690047 + } + ] }, { "style": "Title", @@ -69,36 +132,85 @@ { "style": "Text", "text": "Some topics are broad, have ramifications, or require a nuanced analysis to be covered thoroughly. In such cases, planning for a series of tutorials is ideal.", - "updated": 1617712578718 + "updated": 1617712578718, + "translations": [ + { + "language": "ES", + "text": "Algunos tópicos son amplios, tienen ramificaciones, o requieren un análisis mas profundo para ser cubiertos por completo. en estos casos, la planificación de una serie de tutoriales es lo ideal.", + "updated": 1633365921291 + } + ] }, { "style": "Text", "text": "Take, for example, the series of tutorials in the Trading System Design Tutorials Plugin Workspace:", - "updated": 1617712745906 + "updated": 1617712745906, + "translations": [ + { + "language": "ES", + "text": "Tome, por ejemplo, las series de tutoriales en el Trading System Design Tutorials Plugin Workspace:", + "updated": 1633365963577 + } + ] }, { "style": "List", - "text": "The first tutorial in the series gives a broad introduction to the topic, mostly in conceptual terms. This allows users to see the big picture and learn how the concepts are structured and why they are structured the way they are." + "text": "The first tutorial in the series gives a broad introduction to the topic, mostly in conceptual terms. This allows users to see the big picture and learn how the concepts are structured and why they are structured the way they are.", + "translations": [ + { + "language": "ES", + "text": "El primer tutorial en a serie da una introducción amplia del tópico, mayormente en términos conceptuales. Esto permite a los usuarios ver la la idea completa y aprender a cerca de como los conceptos han sido estructurados y porque están estructurados así.", + "updated": 1633366158719 + } + ] }, { "style": "List", "text": "The second tutorial in the series proposes an exercise that takes several more tutorials to develop and implement. That is, the tutorial sets the basis for what the series will cover.", - "updated": 1617732839409 + "updated": 1617732839409, + "translations": [ + { + "language": "ES", + "text": "El segundo tutorial en la serie propone un ejercicio que incuye varios tutoriales para desarrollar e implementar. Esto es, el tutorial sienta las bases de lo que la serie cubrirá.", + "updated": 1633366319793 + } + ] }, { "style": "List", "text": "The remaining tutorials in the series dissect the exercise proposed earlier and cover with a fine level of detail the implementation. At the same time, they cover all the context and many lateral topics.", - "updated": 1617732881797 + "updated": 1617732881797, + "translations": [ + { + "language": "ES", + "text": "El tutorials siguiente en la serie disecciona el ejercicio propuesto anteriormente y cubre con un nivel fino de detalles la implementación. Al mism tiempo, ellos cubren todo el contexto y muchos temas laterales.", + "updated": 1633366468389 + } + ] }, { "style": "Note", "text": "The whole series threads a common theme and develops it from the simplest to the most complex concepts, step by step. A tutorial series must be exhaustive and eventually, cover the whole topic. It must become the ultimate tool to learn about the subject matter!", - "updated": 1617732933799 + "updated": 1617732933799, + "translations": [ + { + "language": "ES", + "text": "Toda la serie enhebra un tema común y lo desarrolla desde lo más simplea los conceptos más complejos, paso a paso. Una serie de tutoriales debe ser exhaustiva y ocacionalmente cubrir el tópico completo. Debe convertirse en la herramienta definitiva para aprender sobre el tema!", + "updated": 1633366741272 + } + ] }, { "style": "Success", "text": "Consult with project maintainers what would be good names for each tutorial in the series. Naming tutorials with clear and descriptive names is important.", - "updated": 1621875606145 + "updated": 1621875606145, + "translations": [ + { + "language": "ES", + "text": "Consulte a los project maintainers cuúal serían buenos nombres para cada tutorial de la serie. Nombrar tutoriales con nombres claros y descriptivos es importante.", + "updated": 1633366871577 + } + ] }, { "style": "Title", @@ -108,22 +220,50 @@ { "style": "Text", "text": "People are different. We all have slightly different wirings in our heads, and we all learn differently. In that sense, building tutorials is a bit of a challenge. Some people like tutorials that go straight to the point and show them how to solve a very specific issue. Others prefer tutorials that get to the bone, explain every detail, and properly cover the context.", - "updated": 1617733011186 + "updated": 1617733011186, + "translations": [ + { + "language": "ES", + "text": "La gente es diferente. todos tenemos un cableado ligeramente diferente en nuestras cabezas, y todos aprendemos distinto. En ese sentido, construir tutoriales tiene un poco de desafío. A alguna gente le gustan los tutoriales que van derecho al punto y muestran como resolver un tema bien específico. otros prefieren tutoriales que van al hueso, explican cada detalle y cubre adecuadamente el contenido.", + "updated": 1633367166012 + } + ] }, { "style": "Text", "text": "At this early stage, we can't afford to duplicate efforts and build different tutorials for different kinds of learners. We have to choose the method that best serves the project.", - "updated": 1617714108723 + "updated": 1617714108723, + "translations": [ + { + "language": "ES", + "text": "Es en esta etapa temprana, que no podemos darnos el lujo de duplicar esfuerzos y construir tutorials diferentes para distintas clases de aprendices. Tenemos que elegir el método que mejor sirva al projecto.", + "updated": 1633367412845 + } + ] }, { "style": "Important", "text": "We choose to focus on building comprehensive tutorials that everyone can follow and that leave no one behind. We believe that a tutorial that goes slow, covering every detail, and taking the time to explain the nuance is the right approach at this stage. By building tutorials in a such manner, we guarantee that those who are willing to invest the time to learn the system have adequate material to quickly become power users.", - "updated": 1621870335450 + "updated": 1621870335450, + "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 + } + ] }, { "style": "Text", "text": "Such tutorials may be slightly annoying to fast-learners, or to people that just want a specific question answered. But such needs are already covered by the searchable knowledge base comprised in the Docs.", - "updated": 1617714293925 + "updated": 1617714293925, + "translations": [ + { + "language": "ES", + "text": "Estos tutoriales pueden resultar ligeramente molestos para los que aprenden rápido o para gente que solo busca respuesta a una pregunta específica. Pero esas necesidades ya son cubiertas en la base de conocimientos con capacidad de búsqueda incluida en los Docs.", + "updated": 1633368103703 + } + ] }, { "style": "Title", @@ -133,12 +273,26 @@ { "style": "Text", "text": "Let's get into some of the specifics on building tutorials for Superalgos!", - "updated": 1617720149756 + "updated": 1617720149756, + "translations": [ + { + "language": "ES", + "text": "Analicemos algunos de los detalles sobre la construcción de los tutorials para Superalgos!", + "updated": 1633368160422 + } + ] }, { "style": "Callout", "text": "Superalgos tutorials have evolved through several months worth of feedback from early adopters. We feel we have found a sweet spot, and have started to develop a style in the way we use the space available in each tutorial step. The following are some notes that will help you build tutorials that match the format of existing tutorials.", - "updated": 1617733117832 + "updated": 1617733117832, + "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 + } + ] }, { "style": "Title", @@ -148,16 +302,37 @@ { "style": "Text", "text": "The ultimate goal of tutorials is to provide users with a hands-on learning experience covering topics in detail. In general terms, we know that a tutorial is good — or has reached a mature state — when users ask no questions about it in the Support Group.", - "updated": 1620645730740 + "updated": 1620645730740, + "translations": [ + { + "language": "ES", + "text": "La meta final de los tutoriales es proveer a los usuarios con una experiencia de aprendizaje práctica que cubra el tópico al detalle. En terminos generales, sabemos que un tutorial es bueno — o que ha alcanzado su estado maduro — cuando los usuarios no hacen preguntas a cerca de ellos en el Support Group.", + "updated": 1633368718874 + } + ] }, { "style": "Text", "text": "Be precise and unequivocal with language. Read your writing over and over in search of phrases that may not be easily understood, or that may be interpreted in different ways. Improve the sentences to make them as clear as possible. Remember, the less clear your writing is, the more questions we have in the Support Group.", - "updated": 1620645812565 + "updated": 1620645812565, + "translations": [ + { + "language": "ES", + "text": "Se preciso exacto con el lenguaje. Lee lo que ha escrito una y otra vez en búsqueda de frases que pueden no ser entendidas facilmente, o que puedan ser interpretadas de diferentes maneras. Mejora las oraciones para acerlas lo mas claras posibles. Recuerde, mientras menos clara sea su escritura, más preguntas nosotros tendremos en el Support Group.", + "updated": 1633368994567 + } + ] }, { "style": "Success", - "text": "Be prepared to iterate over and over until the tutorial stabilizes. That will happen when there are no more questions about the topic in the Support Group!" + "text": "Be prepared to iterate over and over until the tutorial stabilizes. That will happen when there are no more questions about the topic in the Support Group!", + "translations": [ + { + "language": "ES", + "text": "Esté preparado para itneractuar una y otra vez hasta que el tutorial se estabilice. Eso sucederá cuando no haya más preguntas acerca de el tópico en el Support Group!", + "updated": 1633369113576 + } + ] }, { "style": "Title", @@ -165,7 +340,14 @@ }, { "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!" + "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!", + "translations": [ + { + "language": "ES", + "text": "Use las diferentes secciones de la página y los distintos estilos de párrafos para popósitos concretos. Esto a los usuarios a acostumbrarse a cierto formato para que sepan que esperar en cada sección de la página. La consistencia en el modo en que la información es enviada hace que los tutoriales sean más útiles!", + "updated": 1633369382341 + } + ] }, { "style": "Subtitle", @@ -174,12 +356,26 @@ { "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 + "updated": 1617902992986, + "translations": [ + { + "language": "ES", + "text": "El box de definición es el espacio a la derecha del ícono, debajo el título. Use este espacio para introducir a cerca de qué es el paso, esto es, establecer la historia que el paso contrará, o proveer algún contexto básico.", + "updated": 1633369713286 + } + ] }, { "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 + "updated": 1617903200520, + "translations": [ + { + "language": "ES", + "text": "Para usar la box de definición correctamente, explique el contexto en cuatro o cinco lineas. Evite una o dos lineas o sobrepasar las cinco.", + "updated": 1633369703258 + } + ] }, { "style": "Subtitle", @@ -188,11 +384,25 @@ { "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 + "updated": 1617904108044, + "translations": [ + { + "language": "ES", + "text": "La sección más importante de cualquier paso es el llamad a la acción, esto es, la instrucción que el usuario debe seguir para progresar en el tutorial. Mauchas veces los usuarios rehacen los tutoriales o vuelven atrás un par de pasos para asegurarse que hicieron todo correctamente.", + "updated": 1633369877553 + } + ] }, { "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!" + "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!", + "translations": [ + { + "language": "ES", + "text": "Siempre respete el estilo — el que está en este párrafo — para el llamado a la acción! Al igual, trate de evitar usar este estilo para ninguna otra cosa- Si un paso en particular no tiene llamad a la acción, entonces este estilo no debería estar para nada!", + "updated": 1633370216971 + } + ] }, { "style": "Text", From f4faf0959e03a5d0f75468142218879de53b6c2e Mon Sep 17 00:00:00 2001 From: EvaMaria70 Date: Tue, 5 Oct 2021 15:51:56 +0200 Subject: [PATCH 8/8] This is my contribution to Superalgos --- ...algos-006-how-to-contribute-tutorials.json | 161 +++++++++++++++--- 1 file changed, 140 insertions(+), 21 deletions(-) diff --git a/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-006-how-to-contribute-tutorials.json b/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-006-how-to-contribute-tutorials.json index aaaf88ba4..29e2f964d 100644 --- a/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-006-how-to-contribute-tutorials.json +++ b/Projects/Foundations/Schemas/Docs-Topics/C/Contributing/Contributing-to-Superalgos/contributing-to-superalgos-006-how-to-contribute-tutorials.json @@ -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",