Ayuda:Manual de estilo

A todos los colaboradores: Por favor, no copiéis y peguéis el contenido de la antigua guía en esta. Queremos hacer una cosa nueva, con más y mejor contenido

Introducción

Hemos visto que habéis empezado a añadir contenidos a esta nueva guía de Dapper. Antes de nada nos gustaría daros unas directrices sobre cómo añadir información:

• El título principal de la página ya viene puesto, por lo que las secciones irán como titulares de nivel 2 (Con dos signos de igual rodeando el nombre del título). Un atajo es pulsar sobre el botón con la letra A grande de la barra de edición.

• Ahora ya no va a ser una colección de ¿Cómo instalar...? ya que la inmensa mayoría de las veces se limita a un aptitude install pepito. Ahora las sección deberían tener el nombre del programa o una cadenas más explícita. También habría que explicar un poco sobre el programa e idealmente una captura de pantalla.

• Los programas que ya vienen instalados por defecto en Ubuntu no hace falta explicar como se instalan.

• Para instalaciones normales de programas que ya se encuentran en los repositorios, en lugar de poner la consabida línea $sudo aptitude install pepito hacer una referencia al apartado Primeros pasos/Añadir aplicaciones donde se explican los diversos métodos de instalación que existen.

Añadir nuevos puntos

No más entradas del estilo ¿Cómo instalar...?. La anterior guía se estaba convirtiendo en una acumulación de instrucciones de instalación que, por lo general, aportaban muy poca información al usuario. Las entradas cuya única información era un:

$ sudo aptitude install pepito

ya no deben existir. Se especificará el nombre del paquete y un enlace a la página dónde se explica, de forma única, como instalar programas en Ubuntu (Primeros pasos/Añadir aplicaciones). Así no forzamos a utilizar una consola y la gente puede usar una aplicación gráfica para estos menesteres como es Synaptic. Tampoco tiene ningún sentido explicar como instalar aplicaciones que ya vienen por defecto instaladas en Ubuntu Dapper.

En la portada hay un índice que categoriza la información que hay en el wiki:

1. Instalación
   1. Descarga
   2. Actualización desde Breezy
   3. Instalación limpia
2. Primeros pasos
   1. Activar universe-multiverse
   2. Añadir aplicaciones
   3. Multimedia - Instalar codecs
   4. Instalar la impresora
3. Usuario doméstico
   1. Personalizar el entorno
   2. Accesorios
   3. Ofimática
   4. Video
   5. Audio
   6. Internet
   7. Juegos
   8. Migración desde Windows
   9. Interoperabilidad con Windows
   10. Xgl
4. Administración del sistema
   1. Escritorios remotos
   2. Optimización
   3. Securización
      1. Actualización de paquetes
      2. Desactivación de servicios
      3. Cortafuegos
   4. Recuperación de desastres
   5. Instalación de software
      1. Servidor web
      2. Servidor de correo
      3. Servidor de FTP
   6. Compartición de ficheros e impresoras en red
5. Conoce tu sistema
   1. Los procesos
   2. El arranque
   3. Sistema de ficheros
   4. Configuración de red
6. Programación

Cualquier aportación que añadamos iría dentro de alguna de las categorías o puntos. Tendrás que editar la portada para añadir el enlace a la página en la que vas a añadir la aportación. Cada aportación nueva irá en una página individual. En la otra guía había muchos puntos en algunas páginas y era lento de ver.

Estas categorías principales no se deberán modificar sin consultar previamente con algunos de los administradores de la guía

A la hora de comentar las bondades de una determinada aplicación, la aportación debería tener estos apartados:

• Descripción de la aplicación
  • Comentar características de la misma
  • Paquete que tenemos que instalar y/o proceso de instalación si lo requiere
  • Captura de pantalla con el tema por defecto de Ubuntu Dapper (por homogeneidad)
• Configuración
  • Alguna cosa que debamos saber sobre la configuración
  • Características que deberíamos tener habilitadas por defecto

Actualizando el cambio

En el campo Resumen puedes escribir una breve descripción de la modificación. Teniendo en cuenta que somos muchos lo que estamos viendo y modificando las páginas del wiki constantemente, es muy buena idea rellenar siempre este campo que se mostrará en el historial de la página. Asi de un vistazo vemos que ha pasado entre una versión y otra de la página.

En la página de edición tenemos debajo del área de texto editable unos botones y controles. Con el botón Grabar la página envías la modificación al servidor y está visible para el resto del mundo casi instantáneamente. Por ello siempre antes de enviar los cambios hay que previsualizar lo que hemos editado para comprobar que todo está bien escrito y tiene el aspecto correcto. El botón Mostrar previsualización se encarga de esto.

Si no estamos seguros de qué hemos modificado en área de texto, con el botón Mostrar cambios se verá una lista con las diferencias entre la página original y nuestra modificación.

El controvertido tema de las firmas

En estos momentos veo que hay un pequeño lío sobre el tema de firmar aportaciones. Mucha gente cree que no se deben firmar. No se si por tratarse de una norma de la Wikipedia, ya que ,en un principio, la página de ayuda en la edición de esta guía era la misma que la de la Wikipedia. Esto supongo que es debeido a que si un artículo tiene muchas modificaciones por parte de varias personas, al final habrá un montón de firmas. Y no queda muy bonito que haya más firma que texto :)

Esto ha desembocado en usuarios que borran las firmas de otros y el consiguiente malestar de los firmantes que se quejan del extraño anonimato al que se quiere llevar esto. Los administradores pensamos que los usuarios tienen derecho a firmar sus aportaciones si lo desean. También queremos aclarar que el hecho de no firmar una aportación no la hace anónima, ya que el historial aparecen todas las modificaciones hechas a una página junto con su autor. Pero insistimos en que si alguien lo desea, puede firmar explícitamente.