Ayúdanos a que la documentación de May First se convierta en una herramienta valiosa para nuestra membresía y los movimientos sociales.
Antes de comenzar, por favor lee más sobre cómo organizamos la documentación aquí.
Estas notas ofrecen pautas útiles para redactar cualquier página de documentación, con un enfoque especial en la elaboración de tutoriales y guías del tipo "cómo hacer".
Tamnbién asegúrate de revisar nuestra guía de estilo.
Inicia sesión en nuestro foro Discourse, luego únete a nuestro grupo de trabajo y solicita acceso a la wiki en este hilo.
También puedes contactar con el personal de May First a través de este correo electrónico
Consulta la documentación sobre cómo editar páginas en WikiJS para tener una visión general de su uso.
Recomendamos crear y actualizar páginas que se ajusten a una de las cuatro categorías de documentación que hemos establecido.
Limita la creación de nuevas páginas a las secciones de tutoriales, cómo hacer, referencia o explicación, según la categoría de documentación que mejor refleje el contenido que deseas crear.
| Forma de escribir | Ruta de enlace |
|---|---|
| "cómo hacer" | /es/guide/ |
| explicación | /es/explain/ |
| referencia | /es/reference/ |
| tutoriales | /es/tutorial/ |
Asegúrate de agregar palabras clave y etiquetas relevantes a tu página de documentación. Ejemplos: correo electrónico, Roundcube, sitio web, WordPress, contraseñas.
Si crees que la nueva página debería destacarse en una de nuestras páginas de enlaces seleccionados, no dudes en solicitar ayuda al equipo de documentación de TIAS.
May First se adhiere a los principios de Justicia Lingüística y, dada la diversidad geográfica de nuestra membresía, tenemos un fuerte compromiso con la localización de todas las páginas de documentación al español mexicano y, en general, al español latinoamericano.
Nuestro software wiki cuenta con un sistema de localización, pero no incluye traducción automática. Para traducir manualmente cualquier página, simplemente haz clic en el ícono del globo terráqueo en la esquina superior derecha y crea una nueva página en el idioma que corresponda.
WikiJS almacena las páginas en un repositorio git, que esperamos facilite distintos flujos de trabajo de traducción en el futuro. Por ejemplo, podemos desarrollar scripts que se conecten al repositorio para generar traducciones automáticas de las páginas faltantes utilizando la API de servicios como DeepL, o, preferentemente, importar nuestro repositorio a plataformas como Weblate para gestionar la traducción manual o semimanual, ya sea por parte de personas voluntarias o traductoras experimentadas.