Ayuda:Cómo crear COMOs

De doc.ubuntu-es
Revisión a fecha de 14:18 30 oct 2007; Kelp (Discusión | contribuciones)

(dif) ← Revisión anterior | Revisión actual (dif) | Revisión siguiente → (dif)
Saltar a: navegación, buscar

Antes de escribir un tutorial

Sigue los siquientes pasos:

1. Asegúrate de que no haya ya un tutorial de la misma temática (usa el buscador).

2. Si encuentras un tutorial que coincide, puedes hacer varias cosas:

  • Editar ese tutorial para actualizar la información (en caso de que haya puntos mejorables o actualizables),
  • Si la información a añadir es muy extensa o sensiblemente diferente, puedes crear un nuevo tutorial, enlázandolo al ya existente y creando así una interrelación entre tutoriales parecidos existentes facilitando la navegación y la búsqueda de información a los usuarios.


Escribiendo un tutorial

Hay ciertas "normas" o consejos que se deben seguir a la hora de escribir un tutorial/HOWTO/COMO:

  • Incluye SIEMPRE la siguiente etiqueta al inicio de tu post:
 [[Plantilla:Como]]
  • Utiliza un título descriptivo, exacto y sin información superficial (consulta las normas de edición),
  • Pon tus fuentes de información, a menos que escribas el tutorial por tu propia experiencia. Si estas copipasteando un tutorial de otra persona, cita SIEMPRE al autor.
  • Especifica siempre la versión de Ubuntu que utilizas y la arquitectura (intel, 32 bits, amd 64, etc.) de tu equipo.
  • Explica detalladamente para qué sirve el tutorial.
  • Siempre que se necesiten aplicaciones o librerias extra, coméntalo.
  • Intenta siempre explicar una manera de deshacer lo que se está haciendo.
  • Para que el howto sea de más fácil lectura, utiliza los formatos disponibles. Consulta la ayuda a la edición
  • Advierte siempre de las consecuencias que puede tener el seguir el tutorial en cuestión. A veces son simples trucos, pero otras veces los usuarios pueden correr el riesgo de desestabilizar su instalación.
  • Poner solo enlace a un blog o a otra web no se considera un tutorial.
Herramientas personales