Omitir la navegación de sitio (1) Omitir la navegación de sección (2)

Navegacion de sitio

Proyecto de Documentación de FreeBSD: Proyectos Actuales

Aquí están los proyectos en curso (o siendo activamente contemplados en la lista FreeBSD-doc). También están incluidos algunos que realmente no se ha hablado de ellos, pero serían una buena idea. Cada proyecto lista la persona de contacto para ese proyecto (si sé quién es).

Si piensas que puedes contribuir en cualquier de ellos, por favor, no dudes en hacerlo. Deberís hablar con la persona responsable, quién te pondrá al día de la marcha del proyecto.

Informes de problemas abiertos sobre la documentación

Los informes de problemas abiertos actualmente se siguen mediante la base de datos GNATS. Puedes Ver los informes de documentación actuales.

FreeBSD para usuarios de Linux

Responsable: Annelise Anderson <andrsn@andrsn.stanford.edu>

Sinópsis: Los usuarios de FreeBSD provenientes de Linux pueden tener confusiones por algunas de las diferencias entre los dos sistemas (diferente shell por defecto, cómo funciona la configuración de arranque, y cosas así). Annelise está coordinando el desarrollo de un tutorial/FAQ que reflejará estos puntos.

La lista de preguntas actuales está en http://FreeBSD.stanford.edu/FreeBSD/linux.html.

Actualizar los ficheros FOO.TXT

Responsable: Doug <studded@dal.net>

Sinópsis: Los ficheros "FOO.TXT" son los ficheros README, los INSTALL.TXTs, los ABOUT.TXTs y todos los que obtienes con FreeBSD. Doug (y otras personas) están revisando los contenidos para asegurar que sean cuidados, consistentes y fáciles de entender.

Escribir una sección en las FAQ y/o Handbook

Responsable: Ninguno

Sinópsis: Algunas partes de las FAQ y del Handbook están incompletas, esperando tu aportación. Si has usado alguna parte de la documentación ya existente y encuentras que es complicada o insuficiente, por favor, coméntalo, ofreciendo alguna posible solución.

Alternativamente, si has hecho algo que no existe en la FAQ y/o handbook, por favor, considera escribir una nueva sección.

Reescribir el Handbook :-)

Responsable:Nik Clayton <nik@FreeBSD. org>

Sinópsis: El Handbook ha ido creciendo orgánicamente durante los últimos años. Esto significa que algunas secciones no están organizadas como deberían y otras necesitan ser reescritas.

Actualmente, se ha diseñado un plán para realizar esta tarea y está esperando a que se finalicen otros proyectos de mayor prioridad. Contacta con Nik (preferiblemente a través de la lista de distribución <doc@FreeBSD.org>) para obtener información más detallada.

Escribir algunas informaciones nuevas

La arquitectura VM de FreeBSD

Responsable: John Dyson < dyson@iquest.net>

Sinópsis: FreeBSD 2.x tiene una arquitectura de memoria virtual totalmente renovada. Desafortunadamente no existe ningún tipo de documentación excepto el código fuente y algunos emails antiguos de John Dyson. Mira en FreeBSD VM System Overview para una primera aproximación.

El nuevo SCSI para FreeBSD (CAM)

Responsable: <doc@FreeBSD.org>, <scsi@FreeBSD.org>

Sinópsis: Mira en The Design and Implementation of the FreeBSD SCSI Subsystem para una primera aproximación.

Escribir nuevos Tutoriales

Responsable: <doc@FreeBSD.org>

Sinópsis:

  • Cómo actualizar de a.out a elf
  • Cómo crear una release de FreeBSD

Escribir páginas man para el kernel

Responsable: <doc@FreeBSD.org>

Sinópsis: Documentar funciones de Kernel, sección 9

CGI Scripts

Responsable: <doc@FreeBSD.org, Wolfram Schneider < wosch@FreeBSD.org>

Sinópsis:

  • Reescribir el cgi cvsweb.cgi usando el módulo de Perl RCS.
  • Reescribir el cgi man.cgi y fijar algunos errores.
  • Escribir un módulo en Perl para el INDEX de los ports.

Aquí hay algunos apuntes para el módulo de ports

Una línea en /usr/ports/INDEX es como

   xfig-3.2.2|/usr/ports/graphics/xfig|/usr/X11R6|A drawing program for X11|/usr/ports/graphics/xfig/pkg/DESCR|ports@FreeBSD.ORG|graphics x11|XFree86-3.3.2 Xaw3d-1.3 jpeg-6b xpm-3.4k|XFree86-3.3.2 Xaw3d-1.3 jpeg-6b netpbm-94.3.1 tiff-3.4 transfig-3.2 xpm-3.4k
       

El formato es

   distribution-name|port-path|installation-prefix|comment| \
       description-file|maintainer|categories|build deps|run deps
      

La anterior línea INDEX pasada por un objeto anónimo hash

$port = {
    DISTRIBUTION_NAME   => 'xfig-3.2.2',
    PORT_PATH           => '/usr/ports/graphics/xfig',
    INSTALLATION_PREFIX => '/usr/X11R6',
    COMMENT             => 'A drawing program for X11',
    DESCRIPTION_FILE    => '/usr/ports/graphics/xfig/pkg/DESCR',
    MAINTAINER          => 'ports@FreeBSD.ORG',
    CATEGORIES          => ['graphics', 'x11'],
    BUILD_DEPS          => ['XFree86-3.3.2', 'Xaw3d-1.3', 'jpeg-6b',
                            'xpm-3.4k'],
    RUN_DEPS            => ['XFree86-3.3.2',  'Xaw3d-1.3', 'jpeg-6b',
                'netpbm-94.3.1', 'tiff-3.4', 'transfig-3.2',
                'xpm-3.4k']
};
     

Ahora necesitamos algunas funciones

  • Imprimir un objeto $port como salida HTML
  • Imprimir un obketo $port como salida ASCII
  • Encontrar todos los objetos mantenidos por el usuario XYZ
  • Encontrar todos los objetos que están en la categoría XYZ
  • Encontrar todos los objetos que la compilación/ejecución depende del port XYZ
  • Encontrar todos los objetos que tengan la cadena XYZ en DISTRIBUTION_NAME o COMMENT
  • Ordenar objetos por DISTRIBUTION_NAME

Finalmente

Modificar los cgi's url.cgi, ports.cgi, pds.cgi y el script portindex para usar este módulo.

Contacta con Nik Clayton <nik@FreeBSD.ORG> para una primera muestra del módulo de ports mira aquí.

Web scripts multilenguaje

Responsable: <doc@FreeBSD.org>

Sinopsis:

Nuestras páginas web están escritas en inglés (americano). Los Proyectos de Traducción de FreeBSD traducen el web, Handbook y FAQ a otros lenguajes.

Debemos traducir los cgi's del web y las herramientas de creación del web. Los scripts deberín soportar diferentes lenguajes, no solo uno. Muchos scripts están escritos en Perl.

Traducciones de la documentación de FreeBSD

Responsable: <doc@FreeBSD.org> Traducir la documentación de FreeBSD (Web, FAQ, Handbook, páginas man) a otros idiomas. Mira en el proyecto de traducciones.

Mejoras en el motor de búsquedas

Responsable: <doc@FreeBSD.org>

Cuando realizamos una búsqueda en el web, el resultado que obtenemos es el nombre del fichero en el que se ha encontrado el resultado, siendo algo como FAQ34.html.

Sería mucho más útil si los resultados incluyesen el texto en cuestión, permitiendo al usuario la relevancia del resultado obtenido.

FreeBSD Documentation Project Home