1. El proyecto de Manual Gentoo
El Manual Gentoo está disponible en los siguientes idiomas:
alemán | chino simplificado | español | francés | inglés | italiano | japonés | polaco
Bienvenidos al Manual Gentoo. Aquí encontrará explicaciones que deberían responder la mayoría de las preguntas sobre el manual. Hablaremos acerca de las ideas detrás del mismo, su estado actual, planes futuros y cómo gestionar los informes de errores.
Importante: Actualmente el manual está disponible en castellano para las arquitecturas: amd64, ppc, sparc y x86. |
| Formato | Descripción | Enlaces |
| HTML | Última versión, una página por capítulo, perfecto para ver en línea | x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips, ia64, arm |
| HTML | Última versión, todo en una sola página | x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips, ia64, arm |
| HTML | Última versión, todo en una sola página, versión para imprimir | x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips, ia64, arm |
Con la intención de proporcionar un archivo histórico, permanecen en línea los manuales de versiones anteriores (desde la 2004.2). Se pueden obtener versiones "para imprimir" de las páginas individuales usando el enlace "Print" en la esquina superior derecha. Para obtener la versión "todas las páginas en una", añada ?full=1 al URL.
Aviso: Estos manuales no son actualizados. |
| Versión | Arquitecturas |
| 2004.2 | alpha, amd64, hppa, mips, ppc, sparc, x86 |
| 2004.3 | amd64, hppa, ppc, sparc, x86 |
| 2005.0 | alpha, amd64, hppa, ppc, sparc, x86 |
| 2005.1 | alpha, amd64, hppa, ppc, ppc64, sparc, x86 |
| 2006.0 | alpha, amd64, hppa, ppc, ppc64, sparc, x86 |
| 2006.1 | alpha, amd64, hppa, ppc, ppc64, sparc, x86 |
| 2008.0 | amd64, hppa, ppc, ppc64, sparc, x86 |
3. Información acerca del Manual
El propósito del Manual Gentoo es la creación de 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 es más fácil de mantener, sino que el usuario puede percatarse que son pocas las diferencias y que las demás arquitecturas no sean vistas como entidades separadas.
También nos permite tratar más los puntos difíciles y dar más ejemplos. Además, como ya no estamos obligados a escribir toda la documentación en una sola página, ésta podrá leerse más fluidamente.
Actualmente, la cuarta sección acerca de Configuración de redes en Gentoo está terminada y oficialmente disponible. Cubre en profundidad las opciones para trabajar con redes para el nuevo baselayout estable.
Si le interesa el desarrollo del Manual, por favor use la lista de correo gentoo-doc para sus comentarios.
Reportando errores y peticiones para mejoras
Si encuentra un error en el Manual, por favor visite nuestro Gentoo Linux Bugzilla e archive un reporte de Documentation, para el componente Installation Handbook.
4. Preguntas de uso frecuente (PUF)
¿No se puede tener un Manual creado dinámicamente para cada opción?
Todo es posible, pero hemos optado no hacerlo por varios motivos.
El mantenimiento 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 con agilidad, poniendo mucha atención a cada línea en el Manual, la consistencia, etc.
Aunque actualmente tenemos solamente una versión en línea, otros formatos, tales como PDF, pueden ser desarrollados. Si creásemos PDFs para cada arquitectura y cada opción, tendríamos que proporcionar una cantidad enorme de PDFs con pocas diferencias, lo cual sería una pérdida de recursos :).
Las opciones que escoja un usuario se hacen en distintos lugares. 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 de comenzar, probablemente dándole un buen susto.
La parte acerca de la "Instalación de Gentoo" no es la única parte del Manual Gentoo. Es la primera, pero todas las siguientes son independientes respecto a las opciones escogidas por el usuario. La creación dinámica del manual sólo por las instrucciones de instalación sería demasiado.
El no separar las instrucciones para cada opción posible, permite al usuario ver los resultados de otras opciones con facilidad, ofreciéndole al usuario una mejor perspectiva de las instrucciones de instalación.
No puedo encontrar la información sobre stage1 en el Manual de Gentoo
Las instrucciones sobre el empleo de un archivo stage1 o stage2 están ahora disponibles en el Preguntas frecuentes en Gentoo. La instalación desde stage3 es el único método soportado.
Le agradecemos que por favor reporte su idea, ya que el no estar de acuerdo y no suministrar ideas constructivas no mejora 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.
Sin embargo, 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 imposible 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.
El contenido de este documento está registrado bajo los términos de la licencia Creative Commons - Reconocimiento / Compartir Igual