Estos son algunos consejos sobre cómo escribir una buena página wiki.

• Comenzar la página con un encabezado de primer nivel con un título significativo.
• Ordenar los niveles de los títulos en su orden correcto, las secciones del segundo nivel deben comenzar con un título de segundo nivel.
• Dividir el texto en párrafos dejando una línea vacía entre ellos. Un párrafo promedio no debe tener más de 10-20 líneas.
• Si el texto tiene más de unos pocos (3-5) párrafos, se recomienda dividirlo en secciones agregando títulos de segundo a quinto nivel.
• Cuando el texto tenga más de 2 o 3 páginas de pantalla, coloque un breve resumen del contenido de la página después del primer encabezado. Cuando su página se alargue significativamente, considere dividirla en varias páginas.
• Si el artículo tiene muchos enlaces a otras páginas wiki o recursos externos, agregue una sección especial con más referencias (ver más abajo).
• Si la mayoría de las páginas de un espacio de nombres comparten una estructura común, agregue una plantilla de espacio de nombres para que cualquier página nueva pueda comenzar con esa estructura básica.
• Evitar estructuras de espacios de nombres demasiado complicadas. Intente utilizar nombres de espacios de nombres cortos y fáciles de recordar.

• Enfatizar palabras sueltas o pasajes cortos de texto usando negrita o cursiva . Elegir uno de ellos y luego apegarse a esa elección.
• Usar listas desordenadas para declaraciones que sean independientes entre sí. Si se está desarrollando una línea de pensamiento, escribir en una secuencia continua de oraciones.
• Utilizar las notas a pie de página con moderación y solo para comentarios adicionales muy breves. Si hay mucho más que decir sobre un tema específico, colocarlo en una nueva página wiki. Si se desea consultar otras fuentes de información (externas), utilice enlaces en su lugar.
• Las tablas pueden mejorar enormemente la legibilidad de los datos estructurados. Si inserta una tabla, asegúrese de que tenga encabezados de celda significativos y proporcione un título que indique claramente el contenido de la tabla.

Escriba oraciones adecuadas y use artículos para sustantivos cuando sea necesario. Comience cada oración con una letra mayúscula y termínela con un punto u otra puntuación adecuada. Trate de escribir oraciones cortas y claras sin recurrir demasiado a las cláusulas subordinadas. Cuando crea que ha terminado su página, léala de nuevo y revise cualquier oración que tenga una estructura demasiado complicada. Decide cómo dirigirte a tus lectores. Dado que DokuWiki está orientado a la escritura de documentación, a menudo tendrá que instruir a sus lectores sobre cómo hacer ciertas cosas. Se puede utilizar el imperativo forma ( “ hacer esto!”), Del que / que forma ( “Entonces nos / te clic en …”) o en el que la forma ( “ Me continuación, agregue el foo a bar, usando …”). No mezcle estas formas. Revise su página en busca de errores gramaticales o de ortografía antes de guardarla. Si su texto muestra muchos errores, disminuirá la credibilidad de sus declaraciones, independientemente de lo bien pensadas que sean. Desarrolla tu propio estilo. No se obligue a escribir de una manera con la que no se sienta cómodo. Esto solo sonaría antinatural y desagradable de leer. Referencias Cuando encuentre un término que necesite más explicación, agregue una nueva página wiki para el término y enlace a él. Vuelva a verificar su página antes de terminarla y agregue enlaces a páginas wiki existentes a los términos centrales de su página. No agregue un enlace a cada aparición de un término específico. Haga que la primera aparición o la más destacada en la página sea un enlace y tal vez agregue un enlace a la sección de referencia. Proporcione enlaces a las fuentes de imágenes, datos y citas. Considere agregar una línea “Vea también:” al final de su página. Proporcione enlaces a páginas wiki que estén estrechamente relacionadas con el tema de su página allí. Si desea brindar sugerencias sobre recursos externos que tienen más información sobre su tema o que utilizó al escribir su página, agregue una sección llamada “Referencias” o “Más información” al final y proporcione una lista de enlaces u otras sugerencias ( por ejemplo, números ISBN). Si aún no lo ha hecho en el texto principal, indique la intención de la referencia. La configuración de atajos de interwiki puede ayudar a vincular recursos comunes. Imágenes y otros medios “Una imagen dice más que mil palabras”. Incluso podría significar más de lo que pretendía decir. 1) Los humanos tienden a cuestionar la autenticidad de las imágenes menos que la del lenguaje. Una breve descripción textual es mejor que una imagen inexacta. Al igual que con las tablas, siempre proporcione un título para las imágenes, que indique lo que desea mostrar con la imagen. Si no creó la imagen usted mismo, indique la fuente (posiblemente con un enlace) y los derechos de autor. No vincule imágenes de sitios externos, a menos que se le permita hacerlo explícitamente. En primer lugar, esto es una cuestión de derechos de autor, pero también puede ser una cuestión de robo de ancho de banda cuando el almacenamiento en caché de imágenes externas está desactivado. Si la imagen es más grande que aproximadamente un tercio de la página de la pantalla, use un enlace con instrucciones para cambiar el tamaño para insertar una miniatura.