Bienvenido al manual de contribución. Este documento está diseñado para guiarte paso a paso en el proceso de crear, proponer y organizar contenido dentro de la Wiki UTMACH.
No necesitas ser un experto en tecnología.
Si sabes usar un correo electrónico o escribir en Word, podrás crear contenido aquí siguiendo estas instrucciones.
El objetivo es mantener nuestro repositorio ordenado, útil y fácil de leer para todos.
💡 Consejo antes de empezar:
Tómate tu tiempo. Es mejor tardar unos minutos más creando una página bien ordenada, que horas corrigiendo errores después.
Antes de empezar, es importante entender que no todo contenido se crea de la misma forma.
En la Wiki existen dos tipos oficiales de creación de contenido:
Se usa cuando:
👉 Este tipo de contenido:
/borradoresSe usa cuando:
👉 Importante:
/Borradores📌 Regla clave:
Crear algo nuevo → se mueve
Mejorar algo existente → se propone
Piensa en la Wiki como un archivador gigante de oficina.
Antes de crear un documento, debes saber en qué carpeta va.
Ubícate
Navega primero a la sección donde quieres que aparezca tu página
(ej. Facultades > Ingeniería Civil).
Haz clic en Nueva Página (normalmente arriba a la derecha).
Define la Ruta (la “carpeta”)
Ejemplo correcto:
Borradores/FIC/IngenieriaCivil/Silabo2025**
🚫 Reglas importantes para la ruta:
❌ Mi Página Nueva
✅ MiPaginaNueva
Presiona Crear o Seleccionar.
Elige el Editor
Para que la wiki sea clara y fácil de navegar, cada tipo de contenido debe ir en su lugar correcto.
Unidades académicas
Semestres / ciclos
Asignaturas
Recursos
Documentación institucional
❌ Lo que NO debemos hacer: Crear una página suelta en el "Inicio" que se llame "Examen". Nadie sabrá de qué materia o semestre es.
Antes de escribir el contenido, debemos llenar la "etiqueta" del archivo para que el buscador lo encuentre. Esto suele estar en un panel lateral o ventana de propiedades. Los metadatos ayudan al sistema y a los usuarios a identificar, clasificar y encontrar el contenido.
Normalmente incluyen:
Escribe el nombre real y completo. (Ej: Introducción a la Química Orgánica). Se permiten tildes y espacios.
Es el resumen que aparece en el buscador de la Wiki. Explica qué encontrará el lector, tiene que ser una sola frase clara.
Son palabras clave para agrupar temas. Usa minúsculas y separa con la tecla Enter.
Ejemplo:
microbiologíaunidad-2antimicrobianos📌 No abuses de los metadatos.
📌 Mejor pocos y bien usados.
El título es la primera impresión. Debe ser serio y claro.
Historia de la arquitectura en EcuadorHISTORIA DE LA ARQUITECTURA EN ECUADORUnidad 1: Fundamentos de ProgramaciónUnidad 1 (¿De qué materia?).Los subtítulos ayudan a:
Nunca saltes niveles
(ejemplo: no pasar de título principal directamente a subtítulo muy pequeño).
Aquí es donde ocurren la mayoría de los errores visuales.
Si copias texto directamente desde Microsoft Word y lo pegas aquí, te traerás "basura invisible" (códigos de formato) que dañará el diseño de la página.
La forma correcta de hacerlo:
Ctrl + Shift + V).📌 El texto claro y limpio es más importante que el diseño.
Las listas ayudan a presentar información de forma clara y ordenada.
Se usan cuando el orden no importa.
Ejemplo:
Se usan cuando el orden sí importa (pasos, procesos).
Ejemplo:
Las tablas son ideales para:
📌 Si el contenido se puede leer mejor como texto, no uses tabla.
Las citas sirven para:
Se pueden usar para:
Ejemplo de uso:
📌 No abuses de los bloques destacados, pierden impacto si se usan demasiado.
En la Wiki, las imágenes no se "pegan", se "suben" a la biblioteca primero.
Ojo: Procura que tus imágenes no sean gigantescas. Nómbralas bien antes de subir (ej:
diagrama-solar.jpgen lugar deIMG_2025_X.jpg).
📌 Cada imagen debe aportar información, no solo decoración.
El proceso es idéntico al de las imágenes.
Recomendación: Siempre que sea posible, prefiere subir archivos en PDF. Los archivos de Word pueden verse diferentes según la computadora del estudiante, el PDF siempre se ve igual.
Gracias a las mejoras del sistema, esto ahora es muy fácil.
Las plantillas sirven para:
📌 Las plantillas son una guía, no una restricción.
Las etiquetas ayudan a:
Ejemplos correctos:
unidad-1microbiologiaguia-practicaEjemplos incorrectos:
paginacontenidonuevoAntes de publicar una página, revisa:
📌 Una buena revisión evita correcciones posteriores.
📘 Conclusión
Crear contenido en la wiki no es difícil, pero requiere:
Cada página bien hecha mejora la experiencia de estudiantes, docentes y futuros contribuidores.