La wiki fue iniciada y es mantenida por la Fundación Web3. Es un proyecto de código abierto y pretende ser el recurso más extenso de conocimiento sobre Polkadot y el ecosistema Polkadot. Una gran parte del material se centra actualmente en Polkadot directamente, pero no se opone a cubrir el material informativo para los proyectos de la comunidad.

Por favor, no intentes solicitar material de marketing, ya que será rechazado.

No obstante, se fomentan las solicitudes de extracción, los debates y las contribuciones de la comunidad. Los miembros activos de la comunidad que demuestren un historial de buenas contribuciones pueden recibir acceso por escrito al repositorio.

Por lo demás, la Fundación Web3 mantiene la posición administrativa y la última palabra sobre el contenido que se incluye. En concreto, el equipo de Educación Técnica de la fundación es el que está más directamente implicado.

Consulta el video Cómo contribuir a la Wiki de Polkadot (inglés) para conocer los pasos a seguir en las contribuciones.

Cómo contribuir #

Puedes contribuir a la wiki en el repositorio GitHub w3f/polkadot-wiki. Cada página es un archivo MarkDown, que es una extensión de sintaxis fácil de aprender para el texto plano que hace que la creación de enlaces, la representación de imágenes, y el formato de aspecto agradable sea simple.

Cada página tiene un enlace “Edit this page”(Editar esta página) en la parte inferior del contenido. Al hacer clic en él, se accede a la página de inicio de sesión de GitHub, donde puedes iniciar sesión o crear una cuenta.

Una vez iniciada la sesión, accederás al editor de texto integrado en GitHub, donde podrás realizar tus modificaciones directamente. Cuando hayas completado tus cambios, puedes añadir cualquier detalle específico sobre lo que se ha cambiado y confirmar en una new branch (nueva rama) para crear una nueva Pull Request (solicitud de extracción) en el repositorio. A partir de ahí, uno de los mantenedores revisará tus cambios y los fusionará o solicitará cambios.

Recuerda que después de hacer clic en “Propose Changes” (Proponer cambios), también debes hacer clic en “Create Pull Request”(Crear solicitud de extracción) en la página siguiente.

Directrices y Normas para Contribuir #

Hay algunas reglas básicas para los colaboradores:

1. No presionar  --force ni modificar el historial de Git de ninguna manera
2. Se prefieren los pull requests a los issues, especialmente para pequeños cambios como errores tipográficos. Los issues deben usarse para cambios genéricos o amplios o para contenidos que falten. Se fomentan las sugerencias y peticiones.
3. Utiliza sólo non-master branches.
4. Las modificaciones significativas, incluso las realizadas por los colaboradores, deberían ser objeto de una pull request para solicitar la opinión de otros colaboradores.
5. Se alienta a realizar pull requests para solicitar comentarios para cualquier otra contribución no trivial, pero se deja a la discreción del colaborador.
6. Los colaboradores deben intentar adherir al prevaleciente estilo, lenguaje y diseño de  MarkDown.
7. Se debe utilizar una gramática correcta en todo momento. Los pull requests con errores tipográficos no se fusionarán hasta que sean corregidos.
8. Se debe procurar ser lo más objetivo e informativo posible. No debe haber ningún tipo de editorialización, y no debe haber ningún sesgo externo.
9. Utilizamos un plugin llamado Prettier para estandarizar el estilo en todos los documentos. Puedes ejecutarlo en tu copia local con npx pretty-quick --staged, pero para simplificar también tenemos un bot que lo ejecuta por nosotros en sus PRs.

Patrimonio #

Este documento se basa en las directrices de niveles de contribución.

Ayudar Con Las Traducciones #

El idioma por defecto de la Wiki es el inglés, sin embargo, existe el deseo de traducir la Wiki en tantos idiomas como sea posible. Otra forma de contribuir es ayudando con las traducciones.

Hay una función en la parte inferior de la página principal de la Wiki de Polkadot que te redirigirá a crowdin, que es donde se pueden hacer contribuciones de traducción.

Allí podrás ver el progreso de la traducción de los documentos asociados a la Wiki en muchos idiomas diferentes.

A continuación se indican los pasos para interactuar con la interfaz de crowdin para las traducciones. Consulta también la base de conocimientos oficial de crowdin.

A continuación se muestra un ejemplo en árabe. Puedes escribir la traducción que desees para cada sección en el área proporcionada, mientras utilizas las sugerencias generadas por el traductor incorporado de crowdin.

Asegúrate de guardar tu traducción.