Re: [gnome-hispano] capitulo: /2200 22.- Escribir documentación para aplicaciones GNOME

[Rodrigo Moya <rodrigo gnome-db org>]

On Mon, 2007-12-10 at 23:55 +0100, Domingo González wrote:
> Alejandro Valdes Jimenez escribió:
> > Estimados..
> >
> > favor si tienen un tiempito revizar el capitulo
> > http://es.gnome.org/Documentacion/Desarrollo/EscribirDocumentacionParaAplicacionesGNOME
> >
> > e indicar si está bien enfocado.. que le falta, que le saco...
>
> ¿Qué tal un breve ejemplo sobre cómo implementar la función que llame a
> Yelp y le pase como parámetro el fichero xml?
si, le falta eso, y dónde colocar los archivos en el directorio del
proyecto, lo que hay que poner en los Makefile.am/configure.in, el uso
de gnome-doc-utils, ...

> O como mínimo, hacer referencia al capítulo final donde se hacen los
> ejemplos completos.
>
> Otra idea... ¿dónde iría el archivo de ayuda dentro de la estructura de
> un proyecto GNU?
>
> ¿Merece la pena hablar aquí de generar ficheros para man e info?
si la aplicación incluye comandos sin GUI, debería incluir páginas man
y/o info, así que, si, creo que merece la pena.
-- 
Rodrigo Moya <rodrigo gnome-db org>