Ir al contenido principal

Contribuciones a la documentación

El sitio de documentación de WordPress Playground es mantenido por voluntarios como tú, a quienes les encantaría tu ayuda.

Todos los problemas relacionados con la documentación están etiquetados como [Type] Documentation o [Type] Developer Documentation en el repositorio WordPress/wordpress-playground. Explora la lista de problemas abiertos para encontrar uno en el que te gustaría trabajar. Alternativamente, si crees que falta algo en la documentación actual, abre un issue para discutir tu sugerencia.

¿Cómo puedo contribuir?

Puedes contribuir abriendo un issue en el repositorio del proyecto y describiendo lo que te gustaría añadir o cambiar.

Si te animas, escribe el contenido en la descripción del issue, y los contribuidores del proyecto se encargarán del resto.

Hacer un fork del repositorio, editar archivos localmente y abrir Pull Requests

Si estás familiarizado con markdown, puedes hacer un fork del repositorio wordpress-playground y proponer cambios y nuevas páginas de documentación enviando un Pull Request.

El proceso de crear una rama para abrir nuevos PRs con páginas traducidas en el repositorio WordPress/wordpress-playground es el mismo que para contribuir a otros repositorios de WordPress como gutenberg: https://developer.wordpress.org/block-editor/contributors/code/git-workflow/

Los archivos de documentación (archivos .md) se almacenan en el repositorio de GitHub de Playground, en /packages/docs/site/docs para inglés y en /packages/docs/site/i18n para otros idiomas.

Editar en el navegador

Si has iniciado sesión en GitHub, también puedes editar archivos existentes (o añadir nuevos) y enviar un PR directamente desde la interfaz de usuario de GitHub:

  1. Encuentra la página que te gustaría editar o el directorio del capítulo al que te gustaría añadir una nueva página.
  2. Haz clic en el botón Añadir archivos para añadir un nuevo archivo, o haz clic en un archivo existente y luego en el icono del lápiz para editarlo.
  3. GitHub te pedirá que hagas un fork del repositorio y crees una nueva rama con tus cambios.
  4. Se abrirá un editor donde podrás hacer los cambios.
  5. Cuando hayas terminado, haz clic en el botón Commit Changes y envía un Pull Request.

¡Eso es todo! Acabas de contribuir a la documentación de WordPress Playground.

Este enfoque significa que no necesitas clonar el repositorio, configurar un entorno de desarrollo local ni ejecutar ningún comando.

La desventaja es que no podrás previsualizar tus cambios. Sigue leyendo para aprender a revisar tus cambios antes de enviar un Pull Request.

Previsualización local

Clona el repositorio y navega al directorio en tu dispositivo. Ahora ejecuta los siguientes comandos:

npm install
npm run build:docs
npm run dev:docs

El sitio de documentación se abre en una nueva pestaña del navegador y se actualiza automáticamente con cada cambio. Continúa editando el archivo relevante en tu editor de código y prueba los cambios en tiempo real.