Manual Gentoo 2004.31. El esfuerzo denominado Manual Gentoo El Manual Gentoo está disponible en los siguientes idiomas: Alemán | Chino tradicional | Danés | Español | Francés | Inglés | Indonesio | Italiano | Japonés | Polaco | Rumano 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. Actualmente sólo tenemos parte del Manual (la plataforma x86) traducida de la documentación oficial en inglés, tanto para las versiones 2004.2 como para la actual 2004.3. A medida que las demás arquitecturas estén traducidas, las iremos publicando poco a poco.
3. Información acerca del handbook 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. 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. Actualmente, la tercera parte Trabajando con Portage está terminada (en inglés) y oficialmente disponible. Esta parte contiene explicaciones en profundidad de aspectos del sistema Portage. Si está interesado en el desarrollo del Handbook, por favor use la lista de correo gentoo-doc para sus comentarios o envíe correo electrónico directamente a Sven Vermeulen. Reportando errores y peticiones para mejoras Si encuentra un "bug" o error en el Handbook, por favor visite Gentoo Linux Bugzilla e ingrese un reporte de Docs-user, para el componente 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 fluidamente, poniendo mucha atención a cada línea en el handbook, la consistencia, etc. Aunque actualmente tenemos solamente una versión en línea, otros formatos, como PDF, están siendo desarrollados. Si creásemos PDFs para cada arquitectura y cada opción, tendríamos que producir una enorme cantidad de documentos con pocas secciones de diferencia y 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 que comience, probablemente dándole un buen susto en el proceso. 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. El crear dinámicamente el 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 una mejor perspectiva de las instrucciones de instalación: 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. Le agradecemos que por favor reporte 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. 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 |
|
