Wiki de Tecnología
Documentación de arquitectura, desarrollo, infraestructura y seguridad: procedimientos, decisiones y cómo se despliega cada cosa, en un solo lugar.
Es una prueba. El equipo de Arquitectura TI está evaluando si la herramienta sirve para documentar. Parte en la Gerencia de Tecnología, durante dos semanas.
Para qué sirve
Hoy lo que sabemos vive en nuestras cabezas, en chats, en archivos sueltos y en correos. La Wiki busca que:
- alguien nuevo pueda aprender sin depender de quien tenga tiempo;
- cada proceso tenga una versión escrita de referencia;
- quede registro de por qué se tomó una decisión, para no volver a discutirla;
- se sepa si un documento está vigente, quién lo mantiene y dónde está.
Qué se espera de ti
Documenta algo real que te sirva a ti o a tu equipo: un procedimiento que hoy vive en un chat, una decisión que ya tomaron o cómo se despliega algo. Lo que se mide es si la herramienta ayuda o estorba, no cuánto se escribe.
Cómo empezar
Crea la página
Usa el botón + junto a la sección en el árbol lateral. Si la creas en otro lugar, después la puedes arrastrar.
Escribe con /
Al escribir / se abre el menú de bloques: títulos, listas, tablas, avisos y diagramas. Si ya tienes el texto en Markdown, pégalo y se convierte solo.
Menciona con @
Sirve para enlazar otra página o avisarle a una persona.
Si tienes dudas
Deja un comentario en la página de bienvenida de la Wiki: selecciona el texto al que se refiere tu duda o usa el panel de comentarios. Así la respuesta le sirve también al resto. Si algo cuesta, es justo lo que la prueba necesita saber.
Guías de la herramienta
Documentación oficial, en inglés. Se abre en otra pestaña.
- Editor: bloques, menú /, avisos y cómo pegar Markdown
- Páginas: crear, mover y anidar páginas, historial y comentarios
- Búsqueda: búsqueda global con Ctrl o Cmd + K
- Importar y exportar: traer documentos de Markdown, Word, Confluence o Notion
- Diagramas: Mermaid, Draw.io y Excalidraw