Attachment 44196 Details for Bug 71622 – index.xml

index.xml

index.xml (text/plain), 10.73 KB, created by Jose Luis Rivero (yoswink) (RETIRED) on 2004-11-17 17:07:29 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Jose Luis Rivero (yoswink) (RETIRED)

Created: 2004-11-17 17:07:29 UTC

Size: 10.73 KB

patch

obsolete

>ï»¿<?xml version='1.0' encoding="UTF-8"?>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
>
>
>
><guide link="index.xml">
><title>Manual Gentoo</title>
>
><author title="Autor">
>  <mail link="swift@gentoo.org">Sven Vermeulen</mail>
></author>
>
><author title="Editor-Es">
>  <mail link="bass@gentoo.org">JosÃ© Alberto SuÃ¡rez LÃ³pez</mail>
></author>
><author title="Editor Adjunto-Es">
>  <mail link="chiguire@gentoo.org">John Christian Stoddart</mail>
></author>
><author title="Traductor">
>  <mail link="enrique@barbeito.org">Enrique Barbeito GarcÃa</mail>
></author>
><author title="Traductor">
>  <mail link="fiam@asturlinux.org">Alberto GarcÃa Hierro</mail>
></author>
><author title="Traductor">
>  <mail link="raharu@raharu.org">Gerard LledÃ³</mail>
></author>
><author title="Traductor">
>  <mail link="yoswink@gmail.com">JosÃ© Luis Rivero</mail>
></author>
><author title="Traductor">
>  <mail link="tacvbo@tacvbo.net">Octavio Ruiz</mail>
></author>
><author title="Traductor">
>  <mail link="ToledanoX@gmail.com">Javier SÃ¡nchez Toledano</mail>
></author>
><author title="Traductor">
>  <mail link="">EfraÃn VÃ¡squez</mail>
></author>
><author title="Traductor">
>  <mail link="jyuste09@iespana.es">JuliÃ¡n Yuste</mail>
></author>
>
>
><abstract>
>El Handbook Gentoo es un esfuerzo para centralizar la documentaciÃ³n en
>un forma de un manual coherente. La informaciÃ³n que no pueda ser
>insertada de esta manera, no serÃ¡ tomada en cuenta.
></abstract>
>
><license/>
>
><version>0.20</version>
><date>21 de octubre, 2004</date>
>
><chapter>
><title>El esfuerzo denominado Manual Gentoo</title>
><section>
><title>Idiomas disponibles</title>
><body>
>
><p>
>El Manual Gentoo estÃ¡ disponible en los siguientes idiomas:
></p>
>
><p>
>
><uri link="/doc/de/handbook">AlemÃ¡n</uri> |
><uri link="/doc/zh_tw/handbook">Chino tradicional</uri> |
><uri link="/doc/da/handbook">DanÃ©s</uri> |
><uri link="/doc/es/handbook">EspaÃ±ol</uri> | 
><uri link="/doc/fr/handbook">FrancÃ©s</uri> |
>
><uri link="/doc/en/handbook">InglÃ©s</uri> |
><uri link="/doc/id/handbook">Indonesio</uri> |
><uri link="/doc/it/handbook">Italiano</uri>
></p>
>
></body>
></section>
>
><section>
><title>IntroducciÃ³n</title>
><body>
><p>
>Bienvenidos al Manual Gentoo. AquÃ encontrarÃ¡
>explicaciones que responderÃ¡n la mayorÃa de las preguntas al
>respecto de este manual. Hablaremos acerca de las ideas detrÃ¡s del
>mismo, su estado actual, planes futuros y cÃ³mo manejar los reportes de
>error.
></p>
></body>
></section>
></chapter>
>
><chapter>
><title>Ver el Manual</title>
><section>
><body>
>
><p>
>Actualmente sÃ³lo tenemos parte del Manual (la plataforma x86 totalmente 
>y parte de amd64) traducidas de la versiÃ³n en inglÃ©s, tanto para las versiones
>2004.2 como para la actual 2004.3. A medida que las demÃ¡s pÃ¡ginas estÃ©n 
>traducidas, las iremos publicando poco a poco.
></p>
>
><table>
><tr>
>  <th>Formato</th>
>  <th>DescripciÃ³n</th>
>  <th>Enlace</th>
></tr>
><tr>
>  <ti>HTML</ti>
>  <ti>Ãltima versiÃ³n, una pÃ¡gina por capÃtulo, perfecto para ver en lÃnea</ti>
>  <ti>
>    <uri link="handbook-x86.xml">x86</uri>,
>    <uri link="handbook-alpha.xml">alpha</uri>,
>    <uri link="handbook-amd64.xml">amd64</uri>,
>    <uri link="handbook-hppa.xml">hppa</uri>,
>    <uri link="handbook-mips.xml">mips</uri>,
>    <uri link="handbook-ppc.xml">ppc</uri>,
>    <uri link="handbook-ppc64.xml">ppc64</uri>,
>    <uri link="handbook-sparc.xml">sparc</uri>
>  </ti>
></tr>
><tr>
>  <ti>HTML</ti>
>  <ti>Ãltima versiÃ³n, todo en una sola pÃ¡gina</ti>
>  <ti>
>    <uri link="handbook-x86.xml?full=1">x86</uri>,
>    <uri link="handbook-alpha.xml?full=1">alpha</uri>,
>    <uri link="handbook-amd64.xml?full=1">amd64</uri>,
>    <uri link="handbook-hppa.xml?full=1">hppa</uri>,
>    <uri link="handbook-mips.xml?full=1">mips</uri>,
>    <uri link="handbook-ppc.xml?full=1">ppc</uri>,
>    <uri link="handbook-ppc64.xml?full=1">ppc64</uri>,
>    <uri link="handbook-sparc.xml?full=1">sparc</uri>
>  </ti>
></tr>
>
><tr>
>  <ti>HTML</ti>
>  <ti>Ãltima versiÃ³n, todo en una sola pÃ¡gina, versiÃ³n para imprimir</ti>
>  <ti>
>    <uri link="handbook-x86.xml?style=printable&amp;full=1">x86</uri>,
>    <uri link="handbook-alpha.xml?style=printable&amp;full=1">alpha</uri>,
>    <uri link="handbook-amd64.xml?style=printable&amp;full=1">amd64</uri>,
>    <uri link="handbook-hppa.xml?style=printable&amp;full=1">hppa</uri>,
>    <uri link="handbook-mips.xml?style=printable&amp;full=1">mips</uri>,
>    <uri link="handbook-ppc.xml?style=printable&amp;full=1">ppc</uri>,
>    <uri link="handbook-ppc64.xml?style=printable&amp;full=1">ppc64</uri>,
>    <uri link="handbook-sparc.xml?style=printable&amp;full=1">sparc</uri>
>  </ti>
></tr>
><tr>
>  <ti>HTML</ti>
>  <ti>VersiÃ³n 2004.2, una pÃ¡gina por capÃtulo, perfecto para ver en lÃnea</ti>
>  <ti>
>    <uri link="2004.2/handbook-x86.xml">x86</uri>,
>    <uri link="2004.2/handbook-alpha.xml">alpha</uri>,
>    <uri link="2004.2/handbook-amd64.xml">amd64</uri>,
>    <uri link="2004.2/handbook-hppa.xml">hppa</uri>,
>    <uri link="2004.2/handbook-mips.xml">mips</uri>,
>    <uri link="2004.2/handbook-ppc.xml">ppc</uri>,
>    <uri link="2004.2/handbook-sparc.xml">sparc</uri>
>  </ti>
></tr>
><tr>
>  <ti>HTML</ti>
>  <ti>VersiÃ³n 2004.2, todo en una sola pÃ¡gina</ti>
>  <ti>
>    <uri link="2004.2/handbook-x86.xml?full=1">x86</uri>,
>    <uri link="2004.2/handbook-alpha.xml?full=1">alpha</uri>,
>    <uri link="2004.2/handbook-amd64.xml?full=1">amd64</uri>,
>    <uri link="2004.2/handbook-hppa.xml?full=1">hppa</uri>,
>    <uri link="2004.2/handbook-mips.xml?full=1">mips</uri>,
>    <uri link="2004.2/handbook-ppc.xml?full=1">ppc</uri>,
>    <uri link="2004.2/handbook-sparc.xml?full=1">sparc</uri>
>  </ti>
></tr>
><tr>
>  <ti>HTML</ti>
>  <ti>VersiÃ³n 2004.2, todo en una sola pÃ¡gina, versiÃ³n para imprimir</ti>
>  <ti>
>    <uri link="2004.2/handbook-x86.xml?style=printable&amp;full=1">x86</uri>,
>    <uri link="2004.2/handbook-alpha.xml?style=printable&amp;full=1">alpha</uri>,
>    <uri link="2004.2/handbook-amd64.xml?style=printable&amp;full=1">amd64</uri>,
>    <uri link="2004.2/handbook-hppa.xml?style=printable&amp;full=1">hppa</uri>,
>    <uri link="2004.2/handbook-mips.xml?style=printable&amp;full=1">mips</uri>,
>    <uri link="2004.2/handbook-ppc.xml?style=printable&amp;full=1">ppc</uri>,
>    <uri link="2004.2/handbook-sparc.xml?style=printable&amp;full=1">sparc</uri>
>  </ti>
></tr>
>
>
></table>
></body>
></section>
></chapter>
>
><chapter>
><title>InformaciÃ³n acerca del handbook</title>
><section>
><title>Finalidad</title>
><body>
>
><p>
>El propÃ³sito del Handbook Gentoo es crear un documento coherente que
>describa todos los aspectos posibles de Gentoo Linux. Combina las
>guÃas existentes en un manual consistente, de manera que el mismo
>documento sea usado para todas las arquitecturas posibles, todos los
>tipos de instalaciÃ³n y todos los usuarios. Esto no solo hace que esta
>informaciÃ³n sea mÃ¡s fÃ¡cil de mantener, sino que el usuario puede
>percatarse que las diferencias son pocas y que las demÃ¡s arquitecturas
>no sean vistas como entidades separadas.
></p>
>
><p>
>TambiÃ©n nos permite tratar puntos difÃciles y dar mÃ¡s
>ejemplos. AdemÃ¡s, como ya no estamos obligados a presentar
>toda la documentaciÃ³n en una sola pÃ¡gina, Ã©sta se leerÃ¡ con mayor fluidez.
></p>
>
></body>
></section>
><section>
><title>Estado actual</title>
><body>
>
><p>
>Actualmente, la tercera parte <uri
>link="handbook-x86.xml?part=3">Trabajando con Portage</uri> estÃ¡
>terminada (en inglÃ©s) y oficialmente disponible. Esta parte contiene
>explicaciones en profundidad de aspectos del sistema Portage.
></p>
>
><p>
>Si estÃ¡ interesado en el desarrollo del Handbook, por favor use la
><mail link="gentoo-doc@gentoo.org">lista de correo gentoo-doc</mail>
>para sus comentarios o envÃe correo electrÃ³nico directamente a <mail
>link="swift@gentoo.org">Sven Vermeulen</mail>.
></p>
></body>
></section>
>
><section>
><title>Reportando errores y peticiones para mejoras</title>
><body>
><p>
>Si encuentra un "bug" o error en el Handbook, por favor visite <uri
>link="http://bugs.gentoo.org">Gentoo Linux Bugzilla</uri> e ingrese un
>reporte de <e>Docs-user</e>, para el componente <e>Handbook</e>.
></p>
></body>
></section>
></chapter>
>
><chapter>
><title>Preguntas de uso frecuente (PUF)</title>
><section>
><title>Â¿No se puede mÃ¡gicamente tener un Manual creado dinÃ¡micamente
>para cada opciÃ³n?</title>
><body>
>
><p>
>Todo es posible, pero hemos optado no hacerlo por varios motivos.
></p>
>
><p>
>El <b>mantenimiento</b> de la guÃa serÃa mÃ¡s difÃcil. No solo
>tendrÃamos que cotejar ciertos reportes de error contra ciertas
>decisiones (pocos reportes de error nos dirÃan quÃ© se ha escogido
>anteriormente) pero se harÃa mucho mÃ¡s difÃcil escribir la guÃa
>fluidamente, poniendo mucha atenciÃ³n a cada lÃnea en el handbook, la
>consistencia, etc.
></p>
>
><p>
>Aunque actualmente tenemos solamente una versiÃ³n en lÃnea, <b>otros
>formatos</b>, como PDF, estÃ¡n siendo desarrollados. Si creÃ¡semos PDFs
>para cada arquitectura y cada opciÃ³n, tendrÃamos que producir una
>enormecantidad de documentos con pocas secciones de diferencia y serÃa
>una pÃ©rdida de recursos :).
></p>
>
><p>
>Las opciones que escoja un usuario se hacen en <b>distintos
>lugares</b>. Esto harÃa mÃ¡s difÃcil que el usuario imprima el manual
>-- de forma que tendrÃamos que informar al usuario de todas las
>opciones posibles antes que comience, probablemente dÃ¡ndole un buen
>susto en el proceso.
></p>
>
><p>
>La parte acerca de la "InstalaciÃ³n de Gentoo" <b>no es la Ãºnica
>parte</b> del Manual Gentoo. Es la primera, pero todas las siguientes
>son independientes respecto a las opciones escogidas por el
>usuario. El crear dinÃ¡micamente el manual sÃ³lo por las instrucciones
>de instalaciÃ³n serÃa demasiado.</p>
>
><p>
>El no separar las instrucciones para cada opciÃ³n posible, permite al
>usuario ver los resultados de otras opciones con facilidad, 
>ofreciÃ©ndole <b>una mejor perspectiva de las instrucciones de
>instalaciÃ³n</b>: aunque escoja, por ejemplo, un stage3, estarÃ¡
>fÃ¡cilmente informado acerca de quÃ© hace el stage2 o el
>stage1. Consideramos que el no esconder estas instrucciones es algo
>bueno.
></p>
></body>
></section>
>
><section>
><title>No estoy de acuerdo con ...</title>
><body>
><p>
>Le agradecemos que por favor <uri
>link="http://bugs.gentoo.org">reporte</uri> su idea, ya que el no
>estar de acuerdo y no suministrar ideas constructivas no ayuda la
>situaciÃ³n. La documentaciÃ³n se hace para la comunidad, por lo que la
>retro-alimentaciÃ³n por parte de la comunidad es muy apreciada.
></p>
>
><p>
>Es de notar que la mayorÃa de las decisiones en el proceso de
>desarrollo de la documentaciÃ³n se hacen por consenso. Como es
><e>imposible</e> escribir o estructurar documentaciÃ³n de una manera
>que satisfaga a todos, a veces debemos estar dispuestos a aceptar un
>"no" si creemos que la implementaciÃ³n actual beneficia a la gran
>mayorÃa.
></p>
></body>
></section>
></chapter>
></guide>

Actions: View

Attachments on bug 71622: 44195 | 44196