Files
Superalgos/Projects/Foundations/Schemas/Docs-Topics/A/App/App-Commands/app-commands-001-app-contribute-command.json

288 lines
13 KiB
JSON

{
"topic": "App Commands",
"pageNumber": "1",
"type": "App Contribute Command",
"definition": {
"text": "This command allows you to contribute work to the project. The contribution goes to the Superalgos repository via a Pull Request from your Superalgos fork.",
"updated": 1610909304702,
"translations": [
{
"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,
"style": "Definition"
}
]
},
"paragraphs": [
{
"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,
"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,
"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,
"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,
"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,
"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!",
"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",
"text": "Syntax"
},
{
"style": "Javascript",
"text": "app.contribute [Message]",
"updated": 1615461375106
},
{
"style": "Title",
"text": "Parameters"
},
{
"style": "List",
"text": "Message: Enter a brief description of what your contribution is about. It is optional but appreciated.",
"updated": 1610909386562
},
{
"style": "Title",
"text": "Example",
"updated": 1609943733276
},
{
"style": "Javascript",
"text": "app.contribute Fixed typo.",
"updated": 1615461382913
},
{
"style": "Title",
"text": "For Devs",
"updated": 1609944102567
},
{
"style": "Text",
"text": "This is what the command does:",
"updated": 1610909409653
},
{
"style": "List",
"text": "git.add: adds the changes you've made to contributable files to a git commit.",
"updated": 1610909452789
},
{
"style": "List",
"text": "git.commit: commits all the changes."
},
{
"style": "List",
"text": "git.push: pushes the changes to your fork."
},
{
"style": "List",
"text": "github.createPullRequest: creates a Pull Request at the Superalgos repository, or add commits to an existing Pull Request."
},
{
"style": "Block",
"text": "Block Authentication",
"updated": 1609945385299
},
{
"style": "Title",
"text": "Authentication"
},
{
"style": "Text",
"text": "For the App Contribute Command to run properly, two different authentications are required:",
"updated": 1610909501561
},
{
"style": "List",
"text": "Git Authentication: The first time you run this command, Git will open a pop up window that will ask you for your Github.com credentials. This happens only once. Git will use these credentials to push the commit to your Superalgos fork at Github.com.",
"updated": 1610909551187
},
{
"style": "List",
"text": "Github.com Authentication: The creation of the Pull Request is something that happens at Github.com and for this operation you need to authenticate too. To do this, you must generate a Personal Access Token and set it up at the Github Api node configuration in your active workspace.",
"updated": 1610909615254
},
{
"style": "Subtitle",
"text": "GitHub.com Token"
},
{
"style": "List",
"text": "Create the token by following this link:",
"updated": 1610909635250
},
{
"style": "Link",
"text": "GitHub.com New Token Page->github.com/settings/tokens/new",
"updated": 1609944681129
},
{
"style": "Subtitle",
"text": "Github API Node"
},
{
"style": "Text",
"text": "Once you have your token, find the GitHub API node (you may search for it in the Documentation). The configuration looks like this:",
"updated": 1610909728136
},
{
"style": "Javascript",
"text": "{\n \"username\": \"\",\n \"token\": \"\"\n}",
"updated": 1609944956313
},
{
"style": "Text",
"text": "If you can't find the node by using the search box, it may not exist in the active workspace. The APIs hierarchy is included by default in the Getting Started workspace only. You may spawn a new APIs hierarchy from the Other Hierarchies node in the Superalgos Project hierarchy.",
"updated": 1610909893231
},
{
"style": "Subtitle",
"text": "Properties"
},
{
"style": "List",
"text": "username: Type your GitHub.com username.",
"updated": 1610909927500
},
{
"style": "List",
"text": "token: Paste the token you created.",
"updated": 1610909948426
},
{
"style": "Note",
"text": "You may run the command any time after you made and saved changes.",
"updated": 1610910009790
},
{
"style": "Title",
"text": "Troubleshooting Authentication Issues",
"updated": 1610909171028
},
{
"style": "Text",
"text": "Some issues may arrise when you have more than one Git installation active in your OS.",
"updated": 1610910061699
},
{
"style": "Text",
"text": "For example, if you see the following authentication screen, it means an older version of Git is trying to deal with the authentication:"
},
{
"style": "Png",
"text": "PNGs/Foundations/Docs/third-parties/git-github-authentication.png",
"updated": 1610910471806
},
{
"style": "Text",
"text": "The current authentication screen is similar to this one instead:",
"updated": 1610910533633
},
{
"style": "Png",
"text": "PNGs/Foundations/Docs/third-parties/sign-in-with-your-browser.png",
"updated": 1610910579507
},
{
"style": "Important",
"text": "If you didn't install the latest version of Git before installing Superalgos, then that is likely the reason the authentication is not working. The latest version of Git is required.",
"updated": 1610910817057
},
{
"style": "Success",
"text": "If you did install Git and you are experiencing the issue described above, restarting your PC may help things sort themselves out.",
"updated": 1610910739376
},
{
"style": "Subtitle",
"text": "Linux and iOS",
"updated": 1621085154588
},
{
"style": "Success",
"text": "Input your personal authentication token (PAT) in place of your password and hit enter. ",
"updated": 1621085095513
},
{
"style": "Text",
"text": "If you don't want to keep entering in your token then you can have git cach your credentials:",
"updated": 1621085196186
},
{
"style": "Link",
"text": "How to Cache your Git Credentials->docs.github.com/en/github/getting-started-with-github/caching-your-github-credentials-in-git",
"updated": 1621085386878
},
{
"style": "Text",
"text": ""
},
{
"style": "Text",
"text": ""
}
]
}