Guía de estilo de openSUSE
Por favor sigue las especificaciones de este documento cuando crees o edites artículos en este wiki.
Contenido
Títulos de artículos
El nombre de tu artículo es también el encabezado. Pon un título claro, no uses abreviaturas confusas, y no uses palabras juntas DeEstaManera. No repitas el título del artículo en el encabezado. No debes crear tus propios espacios de nombres. Usa mayúsculas en para la primera letra de las palabras en los encabezados y los subtítulos. No abuses de ellas (ej: Correo electrónico, NO Correo Electrónico).
Encabezados
- Usa el simbolo = (encabezado) y no el simbolo ''' (negrita) para crear un encabezado. De este modo, la tabla de contenidos (TOC) se genera automáticamente a partir de los encabezados.
- Inicia con solo un = y no con dos ==. Por ejemplo:
=Encabezado 1= ==Subtítulo 1.1== ==subtítulo 1.2== =Encabezado 2= ==subtítulo 2.2== ===subtítulo 2.2.1=== ====subtítulo 2.2.1.1===
- Los Encabezados facilitan a las personas leer rápidamente sólo lo que desean y omitir las partes en las que no están interesadas.
- Si tu texto comienza a ser muy largo, considera dividirlo en subtitulos.
- Usa mayúsculas para la primera letra de las palabras en los títulos.
Etiqueta adecuadamente tu texto
Usa las características de formato de MediaWiki para hacer tu texto mas fácil de leer. Pon los nombres de archivos y comandos en una fuente de ancho uniforme:
<tt>fuente de ancho uniforme</tt>
Utiliza el conjunto de características de MediaWiki
No uses formato HTML a menos que sea absolutamente necesario. Al usar en formato de MediaWiki das a los artículos un aspecto y sensacion consistente y hace, al código fuente, fácil de escribir, leer y editar. Por favor visita el artículo Cómo se edita una página para ver las herramientas de formato y etiquetado que puedes usar. También puedes ver en el código fuente de algunos Artículos de Wikipedia.
Comentarios
Como lector, usa las páginas de discusión de los artículos para publicar tus comentarios. No desordenes el texto del artículo.
Como escritor, evita que tu artículo parezca incompleto o que está sin finalizar, excepto con el uso de {{plantillas}} o templates.
De igual manera, no tiene beneficio alguno para el lector ver encabezados y tablas sin contenido.
Si deseas comunicarte con otro editor potencial, haz comentarios invisibles al lector normal del artículo. Para lograr esto, encierra el texto que desees que solo lean los editores entre <!-- y -->.
Por ejemplo, lo siguiente:
hola <!--Este es un comentario.--> a todos
se muestra así:
- hola a todos
Así, el comentario se verá cuando un editor lea el código fuente wiki o HTML.
Debes evitar el crecimiento artificial
No debes crear artículos vacíos, los artículos deben contener un mínimo de información relevante. El modo de sugerir un artículo en el wiki para que alguien lo escriba, es crear un enlace a él. Si hay al menos dos enlaces al mismo artículo inexistente, este aparecerá en la lista de Páginas Deseadas.
Los errores más comunes
- Abuso de mayúsculas tanto en los títulos de las páginas como en los encabezados. Ejemplo: NO pongas "Guía de Estilo" en el título o en el encabezado. Lo correcto sería "Guía de estilo."
- No añadir una página nueva a una categoría/no enlazarla.
- Poner la primera o de openSUSE en mayúscula.
- Traducción de nombres. Por ejemplo "Factory". No se traducen.
- Usar usted. El wiki es un sitio informal. Por favor, usa "tú" en vez de "usted."
- Traducir palabras de forma incorrecta. Por ejemplo:manager como "manejador". Esa palabra no existe en castellano. Lo correcto sería usar "gestor". Otros casos: report a bug → informar de un fallo (no "reportar un bug"). Evita usar anglicismos o inventarte palabras :-P
- No usar acentos. Por favor, no te olvides de poner acentos allí donde corresponda :)