Re: [gnome-hispano] Enfoque del libro

[Domingo González <gonav ono com>]

En la reunión de Zaragoza 2006 se planteó el siguiente enfoque a la hora
de redactar el libro.

- Establecer cuál es el objetivo del libro, a nivel de conocimientos (es
decir, qué nivel se quiere enseñar, y no pasar de ahí, y mantener ese
nivel en todo el libro). En este caso, los ejemplos finales nos sirven
para marcar el objetivo del libro, y establecen el nivel de lo que se va
a explicar en el libro.

- Los ejemplos deben contener todo lo explicado en el texto, o bien el
texto debe explicar lo necesario para hacer el ejemplo. Si algo se
utiliza en el ejemplo, debería estar explicado en el libro. Hay que
intentar además que se muestren en los ejemplos todo lo que se explica
en el texto.

- En la redacción de los capítulos del libro, hay que intentar no
profundizar más de la cuenta, o explicar cosas que no sean necesarias.
Siempre plantearse la pregunta "¿esto es estrictamente necesario
ponerlo?". El punto de equilibrio está en poner lo mínimo necesario para
cumplir el objetivo del capítulo. El resto no hace más que confundir al
lector.

- De acuerdo con el criterio anterior, lo ideal es poner en cada
capítulo o apartado una o varias referencias a documentación externa,
para ampliar sobre ese tema.

- No explicar en dos sitios diferentes lo mismo, usar referencias
cruzadas. Esto evita duplicar trabajo y tener la información dispersa.
Un ejemplo: GtkTreeView en la parte de Gtk y en la parte de Glade, si se
necesita para la parte de Glade algo más de lo que aparece en la parte
de Gtk, lo ideal es añadirlo allí y referenciar.

- En todos los apartados que haya código, salvo excepciones razonables,
se intentará que el ejemplo esté completo (listo para compilar), con el
fin de que los lectores puedan compilarlo y ver los resultados. Al
final, junto con el libro para descargar, se pondrá un tar.gz con todo
el código del libro.

Pido la ayuda de todos, y especialmente aquellos con experiencia
docente, para que aportéis vuestras sugerencias con el fin de lograr un
curso lo más didáctico posible.

Por otra parte, en el capítulo introductorio se establecen las bases de
todo el libro. Ruego su lectura y comentarios al mismo.
http://es.gnome.org/Desarrollo/Introduccion

Gracias.