Diferencia entre revisiones de «Ayuda:Estilo De Notas»

De Dos Ideas.
Saltar a: navegación, buscar
(Cantidad de información)
(yVNbmKlPrEDryBnUq)
 
Línea 1: Línea 1:
Para tener una wiki ordenada y prolija, veremos a continuación una serie de convenciones y consejos a la hora de escribir una página wiki en Dos Ideas.
+
Wow! That's a raelly neat answer!
 
 
==Idioma==
 
Preferimos el uso de '''castellano''' en la medida de lo posible. Evitamos el uso de inglés u otros idiomas cuando existen términos y expresiones en castellano de uso habitual.
 
 
 
Usamos la terminología en inglés (u otro idioma) cuando no exista una traducción exacta, o la expresión sea más comunmente usada en su idioma original.
 
 
 
==Estilo de escritura==
 
En la medida de lo posible usamos un estilo impersonal e informal.
 
Configuro el archivo x.properties para... //NO ESCRIBIR ASI
 
Se configura el archivo x.properties...  //PREFERIBLE
 
 
 
==Nombres de las páginas==
 
El nombre de cada página wiki tiene que tener sentido y servir para ubicar el contenido. Ejemplos:
 
Ejemplo de uso            //NO! No está en claro sobre QUE tema se verá el ejemplo
 
EjemploDeUsoDeFoo        //NO! No "pegar" todas las palabras, usar espacios
 
Ejemplo De Uso De Foo    //NO! Solo usar mayúsculas cuando es necesario
 
Ejemplo de uso de Foo    //OK. Viendo el titulo se sabe qué se encontrará en la página
 
Anotaciones              //Uso general de anotaciones, sin referencia a ninguna tecnología en particular
 
Anotaciones con Foo      //Queda claro que se verán anotaciones para la tecnología Foo
 
 
 
Sólo usar mayúsculas para la primer letra de la página, o cuando se hace referencia a un nombre.
 
Ejemplo de uso        //OK
 
Ejemplo De Uso        //NO! no usar mayúsculas innecesariamente
 
 
 
'''Nota sobre las mayúsculas''': varias páginas de la wiki comenzaron siguiendo una convención distinta sobre las mayúsculas. Por favor, para páginas nuevas seguir esta nueva convención.
 
 
 
En el caso de siglas, usar mayúsculas para todas las letras de la sigla. Por ejemplo:
 
Mensajeria con MDB
 
Pruebas ee EJB
 
Desarrollo con TDD
 
 
 
Evitar las páginas con nombres de una sola palabra, a menos que se trate de nombres de tecnologías.
 
 
 
==Cantidad de información==
 
Cada página tiene que ser "autocontenida". Es decir, tiene que aportar algo por sí misma.
 
 
 
== Fin de la nota==
 
Terminamos la nota con dos grupos de links: hacia otros temas de la misma wiki, y hacia recursos externos, en este orden.
 
Todos estos temas se ubican bajo el título de nivel 2 "Ver también". Por ejemplo:
 
 
 
<pre>
 
<nowiki>
 
==Ver también==
 
* [[Una página wiki relacionada]]
 
* [[Otra página wiki relacionada]]
 
* [http://www.foo.org Web oficial de Foo]
 
* [http://www.foo.org/tutorial Tutorial de Foo]
 
</nowiki>
 
</pre>
 
 
 
== Categorías ==
 
Ubicar la página en una o más categorías, para facilitar su búsqueda. En el caso de categorías con sub-categorías, ubicar el artículo en la subcategoría más específica (evitando agregar a la categoría padre).
 
 
 
Escribir los tags de Categoría al final de la página wiki.
 
 
 
Por ejemplo, un artículo que habla sobre el uso de Web Services con Spring Framework:
 
<pre>
 
<nowiki>
 
[[Categoría:Spring Framework]]
 
[[Categoría:Web Service]]
 
</nowiki>
 
</pre>
 

Revisión actual del 08:20 6 sep 2011

Wow! That's a raelly neat answer!