Ayuda:Tipos de contenidos

De doc.ubuntu-es
(Diferencias entre revisiones)
Saltar a: navegación, buscar
(ampliando contenido)
(erratas)
 
(No se muestran 3 ediciones intermedias realizadas por un usuario)
Línea 1: Línea 1:
{{Nota| '''Esto es solo un borrador''' en proceso de edición, las normas de edición de este sitio aun están por definir (aunque las antiguas han quedado abolidas). Por favor, no edites esta página, cualquier comentario, crítica o sugerencia, hazla en la página de discusión.}}
+
{{Nota| '''Esto es solo un borrador''' en proceso de edición, las normas de edición de este sitio aún están por definir (aunque las antiguas han quedado abolidas). Por favor, no edites esta página, cualquier comentario, crítica o sugerencia, hazla en la página de discusión.}}
 
<div style="float:right;">__TOC__</div>
 
<div style="float:right;">__TOC__</div>
 +
  
 
==Diversidad de contenidos==
 
==Diversidad de contenidos==
  
Este es un proyecto de documentación de amplio espectro, la diversidad de las temáticas y la diversidad en las maneras de exponer la información es tal, que es imposible establecer un único modelo de documento que sea valido en todas las circunstancias.
+
Este es un proyecto de documentación de amplio espectro, la diversidad de las temáticas y la diversidad en las maneras de exponer la información es tal, que es imposible establecer un único modelo de documento que sea válido en todas las circunstancias.
  
 
Es importante que al crear un documento nuevo tengas claro qué tipo va a ser. Del mismo modo, cuando edites un documento existente debes tener presente qué tipo de documento es.
 
Es importante que al crear un documento nuevo tengas claro qué tipo va a ser. Del mismo modo, cuando edites un documento existente debes tener presente qué tipo de documento es.
 +
  
 
==Tipos de documentos==
 
==Tipos de documentos==
Línea 14: Línea 16:
 
Son semejantes a las entradas de la wikipedia. Sus características principales son:
 
Son semejantes a las entradas de la wikipedia. Sus características principales son:
 
* Ocupan una sola página.
 
* Ocupan una sola página.
* Tienen un nombre simple. la página sobre 'la cosa' se titulará 'cosa'. Por ejemplo, la página del gestor de arranque de Ubuntu, el GNU GRUB, se llamará [[w:GRUB]]
+
* Tienen un nombre simple. la página sobre 'la cosa' se titulará 'cosa'. Por ejemplo, la página del gestor de arranque de Ubuntu, el GNU GRUB, se llamará [[w:GRUB|GRUB]]
 
* Su contenido debe explicar qué es la cosa, cómo es la cosa y, en general, toda la información útil par que el lector conozca 'la cosa', además de enlaces para profundizar en la materia.
 
* Su contenido debe explicar qué es la cosa, cómo es la cosa y, en general, toda la información útil par que el lector conozca 'la cosa', además de enlaces para profundizar en la materia.
 
** No debe ser un manual de uso de 'la cosa', aunque pueda o deba tener un enlace a uno.
 
** No debe ser un manual de uso de 'la cosa', aunque pueda o deba tener un enlace a uno.
  
El echo de que Ubuntu publique una nueva versión cada 6 meses que suele tener versiones nuevas de muchos programas dificulta la creación de artículos de este tipo que sean útiles para todos los usuarios sin resultar farragosos al contener información sobre todas la versiones. Para solucionar este problema, en {{SITENAME}}, cada versión tiene su propio manespaces.
 
 
Por lo tanto, 'la cosa' debería tener los siguientes artículos enciclopédicos:
 
* cosa : en el namespaces principal, debe contener una descripción general independiente de cualquier versión especifica.
 
* 11.04:cosa ; en el namespaces 11.04, debe contener una descripción específica de la cosa en esa versión de ubuntu
 
* 11.10:cosa ; en el namespaces 11.10...
 
 
De esta forma el usuario puede escoger si consulta la información general sobre 'la cosa', o la específica de la versión de Ubuntu que usa.
 
  
 
=== Introducciones ===
 
=== Introducciones ===
  
 
Una 'introducción a...' Es un documento en el que se da una explicación básica general sobre un tema de forma que sea útil para usuarios sin conocimientos sobre el tema.
 
Una 'introducción a...' Es un documento en el que se da una explicación básica general sobre un tema de forma que sea útil para usuarios sin conocimientos sobre el tema.
 +
  
 
=== Guías ===
 
=== Guías ===
  
 
Son explicaciones paso a paso que guían al lector hacia un objetivo.
 
Son explicaciones paso a paso que guían al lector hacia un objetivo.
Por ejemplo: Guia de instalación de Ubuntu 11.10- explicaría paso a pasa la instalación estándar de ubuntu 11.10
+
Por ejemplo: Guía de instalación de Ubuntu 11.10- explicaría paso a pasa la instalación estándar de ubuntu 11.10.
 +
 
  
 
=== Cómos ===
 
=== Cómos ===
  
Son documentos finalistas sobre cómo conseguir tal objetivo. se diferencian de las guías en que no son pasa a paso, ni se centran en un único camino.
+
Son documentos finalistas sobre cómo conseguir tal objetivo. Se diferencian de las guías en que no son paso a paso, ni se centran en un único camino.
Por ejemplo: Como instalar Ubuntu 11.10 - trataría sobre los distintos métodos de instalación de Ubuntu 11.10
+
Por ejemplo: Cómo instalar Ubuntu 11.10 - trataría sobre los distintos métodos de instalación de Ubuntu 11.10.
 +
 
  
 
=== Manuales ===
 
=== Manuales ===
  
Son recilaciones de conocimiento no finalista sobre un tema
+
Son recopilaciones de conocimiento no finalista sobre un tema.
  
 +
 +
== Artículos "de autor" ==
 +
 +
{{SITENAME}} tiene unas políticas, normas de edición y de estilos. Si bien en condiciones normales esto es positivo y necesario, toda norma tiene sus excepciones. Por otro lado, no queremos que estas normas restrinjan la creatividad de los editores.
 +
 +
Próximamente se creará una sección -namespace- especial en la que los editores podrán publicar contenidos que no cumplan las normas.
 +
 +
Por ejemplo, tenemos una política que exige que los contenidos sean neutrales. Es esta sección "de autor" podrán publicarse contenidos subjetivos en los que los editores puedan explicar los temas desde su punto de vista personal.
  
 
== Profundidad de los documentos ==
 
== Profundidad de los documentos ==
  
{{SITENAME}} pretende ser útil para todos los usuarios, algunos pueden ser expertos, otros pueden ser principiantes. No es factible crear un documento sobre un tema que sea práctico para todos. Por ello, al crear un documento tienes que tener claro a que perfil de usuario va dirigido. Estos perfiles pueden ser cuatro:
+
{{SITENAME}} pretende ser útil para todos los usuarios, algunos pueden ser expertos, otros pueden ser principiantes. No es factible crear un documento sobre un tema que sea práctico para todos. Por ello, al crear un documento tienes que tener claro a qué perfil de usuario va dirigido. Estos perfiles pueden ser cuatro:
 
* 0 - Usuarios sin conocimientos previos  
 
* 0 - Usuarios sin conocimientos previos  
 
** Una introducción a Firefox explicaría lo más básico, como ver páginas, manejar pestañas, los marcadores...
 
** Una introducción a Firefox explicaría lo más básico, como ver páginas, manejar pestañas, los marcadores...
Línea 54: Línea 59:
 
** Un manual para Firefox de nivel medio explicaría con bastante detalle todas las funcionalidades principales del programa
 
** Un manual para Firefox de nivel medio explicaría con bastante detalle todas las funcionalidades principales del programa
 
* 2 -Usuarios con conocimientos avanzados
 
* 2 -Usuarios con conocimientos avanzados
** Un manual para Firefox de nivel avanzado explicaría con todo detalle todas las funcionalidades del programa escepto lás más basicas qe se dan por supuestas
+
** Un manual para Firefox de nivel avanzado explicaría con todo detalle todas las funcionalidades del programa excepto las más básicas, que se dan por supuestas
 
* 3 - Hackers (en el buen sentido)
 
* 3 - Hackers (en el buen sentido)
** Un 'Hackeando firefox' debe explicar como meterle mano al código del programa, como crear extensiones y complementos, programación con XUL...
+
** Un 'Hackeando firefox' debe explicar cómo meterle mano al código del programa, cómo crear extensiones y complementos, programación con XUL...
 +
 
 +
 
 +
== Namespaces ==
 +
 
 +
El hecho de que Ubuntu publique una nueva versión cada 6 meses, que suele tener versiones nuevas de muchos programas, dificulta la creación de artículos de este tipo que sean útiles para todos los usuarios sin resultar farragosos, al contener información sobre todas la versiones. Para solucionar este problema, en {{SITENAME}}, cada versión tiene su propio [[Ayuda:Namespaces|namespaces]].
 +
 
 +
Por lo tanto, 'la cosa' debería tener los siguientes artículos enciclopédicos:
 +
* Cosa : en el namespaces principal, debe contener una descripción general independiente de cualquier versión específica.
 +
* 11.04:Cosa ; en el namespaces 11.04, debe contener una descripción específica de la cosa en esa versión concreta de ubuntu
 +
* 11.10:Cosa ; en el namespaces 11.10...
 +
 
 +
De esta forma el usuario puede escoger si consulta la información general sobre 'la cosa', o la específica de la versión de Ubuntu que usa.
 +
 
 +
<!-- CATEGORÍAS -->
 +
[[Categoría:Ayuda]]

Última revisión de 18:20 22 jun 2012

Clip.png Esto es solo un borrador en proceso de edición, las normas de edición de este sitio aún están por definir (aunque las antiguas han quedado abolidas). Por favor, no edites esta página, cualquier comentario, crítica o sugerencia, hazla en la página de discusión.


[editar] Diversidad de contenidos

Este es un proyecto de documentación de amplio espectro, la diversidad de las temáticas y la diversidad en las maneras de exponer la información es tal, que es imposible establecer un único modelo de documento que sea válido en todas las circunstancias.

Es importante que al crear un documento nuevo tengas claro qué tipo va a ser. Del mismo modo, cuando edites un documento existente debes tener presente qué tipo de documento es.


[editar] Tipos de documentos

[editar] Artículo enciclopédico

Son semejantes a las entradas de la wikipedia. Sus características principales son:

  • Ocupan una sola página.
  • Tienen un nombre simple. la página sobre 'la cosa' se titulará 'cosa'. Por ejemplo, la página del gestor de arranque de Ubuntu, el GNU GRUB, se llamará GRUB
  • Su contenido debe explicar qué es la cosa, cómo es la cosa y, en general, toda la información útil par que el lector conozca 'la cosa', además de enlaces para profundizar en la materia.
    • No debe ser un manual de uso de 'la cosa', aunque pueda o deba tener un enlace a uno.


[editar] Introducciones

Una 'introducción a...' Es un documento en el que se da una explicación básica general sobre un tema de forma que sea útil para usuarios sin conocimientos sobre el tema.


[editar] Guías

Son explicaciones paso a paso que guían al lector hacia un objetivo. Por ejemplo: Guía de instalación de Ubuntu 11.10- explicaría paso a pasa la instalación estándar de ubuntu 11.10.


[editar] Cómos

Son documentos finalistas sobre cómo conseguir tal objetivo. Se diferencian de las guías en que no son paso a paso, ni se centran en un único camino. Por ejemplo: Cómo instalar Ubuntu 11.10 - trataría sobre los distintos métodos de instalación de Ubuntu 11.10.


[editar] Manuales

Son recopilaciones de conocimiento no finalista sobre un tema.


[editar] Artículos "de autor"

doc.ubuntu-es tiene unas políticas, normas de edición y de estilos. Si bien en condiciones normales esto es positivo y necesario, toda norma tiene sus excepciones. Por otro lado, no queremos que estas normas restrinjan la creatividad de los editores.

Próximamente se creará una sección -namespace- especial en la que los editores podrán publicar contenidos que no cumplan las normas.

Por ejemplo, tenemos una política que exige que los contenidos sean neutrales. Es esta sección "de autor" podrán publicarse contenidos subjetivos en los que los editores puedan explicar los temas desde su punto de vista personal.

[editar] Profundidad de los documentos

doc.ubuntu-es pretende ser útil para todos los usuarios, algunos pueden ser expertos, otros pueden ser principiantes. No es factible crear un documento sobre un tema que sea práctico para todos. Por ello, al crear un documento tienes que tener claro a qué perfil de usuario va dirigido. Estos perfiles pueden ser cuatro:

  • 0 - Usuarios sin conocimientos previos
    • Una introducción a Firefox explicaría lo más básico, como ver páginas, manejar pestañas, los marcadores...
  • 1 -Usuarios con conocimientos medios
    • Un manual para Firefox de nivel medio explicaría con bastante detalle todas las funcionalidades principales del programa
  • 2 -Usuarios con conocimientos avanzados
    • Un manual para Firefox de nivel avanzado explicaría con todo detalle todas las funcionalidades del programa excepto las más básicas, que se dan por supuestas
  • 3 - Hackers (en el buen sentido)
    • Un 'Hackeando firefox' debe explicar cómo meterle mano al código del programa, cómo crear extensiones y complementos, programación con XUL...


[editar] Namespaces

El hecho de que Ubuntu publique una nueva versión cada 6 meses, que suele tener versiones nuevas de muchos programas, dificulta la creación de artículos de este tipo que sean útiles para todos los usuarios sin resultar farragosos, al contener información sobre todas la versiones. Para solucionar este problema, en doc.ubuntu-es, cada versión tiene su propio namespaces.

Por lo tanto, 'la cosa' debería tener los siguientes artículos enciclopédicos:

  • Cosa : en el namespaces principal, debe contener una descripción general independiente de cualquier versión específica.
  • 11.04:Cosa ; en el namespaces 11.04, debe contener una descripción específica de la cosa en esa versión concreta de ubuntu
  • 11.10:Cosa ; en el namespaces 11.10...

De esta forma el usuario puede escoger si consulta la información general sobre 'la cosa', o la específica de la versión de Ubuntu que usa.

Herramientas personales