Sondeo sobre la biblioteca GH Freebrary

[Ñuño Martínez]

En cuanto a la documentación, ¿has probado pasdoc? Yo lo uso con Allegro.pas y va de maravilla. Además, facilita coger la costumbre de documentar al mismo tiempo que estás escribiendo el código, lo cual es lo mejor que puede hacerse.

[[Al González]]

Empezado por Ñuño Martínez

En cuanto a la documentación, ¿has probado pasdoc? [...]

Te soy sincero, Ñuño, no me convence la idea de usar documentación automatizada, creo que eso reduciría la "estética" del código y dificultaría su manejo. Además, todos los comentarios que van en el código fuente los escribo en inglés, aunque a veces me lleva eternos minutos redactar unas cuantas líneas que le parezcan aceptables a quienes hablan ese idioma. Si bien puede ser difícil al principio, considero que lo anterior es algo que debería procurarse con cualquier biblioteca de programación de uso público: usar el idioma inglés tanto para el código fuente como para los comentarios que van en él.

En cambio para la documentación o "manual de referencia", como ya has notado, uso el castellano. No me considero capaz de escribir algo tan formal en el idioma de Mark Twain; ya llegarán —espero— varios samaritanos que comprendan el español leído, sean diestros en el inglés y aporten cinco o diez horas de su valiosa vida ayudando a traducir el manual.

Por otro lado, creo que utilizar el propio foro para la documentación ofrece varias ventajas, como es un adecuado formato de presentación, la disponibilidad pública en la Red y la retroalimentación con los usuarios. De hecho me extraña que hasta el momento nadie más haya publicado alguna biblioteca en el nuevo foro.

Saludos.

P.D. 334 visitas y sólo seis votantes...

[Ñuño Martínez]

Yo es que no he encontrado una herramienta mejor, hasta ahora, de ahí que la recomiende.

[[Al González]]

Deseo comentarles que el 80% de las unidades GHFRTL, GHFVCL y GHFUtils ya se encuentra disponible en la edición para XE2. Y también TghStrList (opción 8), la cual es una clase muy sencilla que extiende algunas capacidades de la conocida TStringList.

Les recuerdo que esta encuesta permanecerá abierta hasta el 2 de diciembre de 2014, pero su participación ahora es muy importante. Los exhorto a dar clic en las opciones de su interés. Por si hubiera alguna confusión, la leyenda "Tú no puedes votar en esta encuesta" significa que primero hay que ingresar con su clave de usuario.

Saludos.

[[Al González]]

¿Quién falta de votar?

¿Falta alguna opción?

[Ñuño Martínez]

¿Sólo seis votantes? Pensaba que había más interés.

[[Al González]]

Empezado por Ñuño Martínez

¿Sólo seis votantes? Pensaba que había más interés.

Lo extraño es que aun para los que no tienen interés o conocimiento alguno sobre GHF hay una opción (la última), pero la escasa votación parece más bien reflejar cierta apatía por participar en este tipo de sondeos. Quizá no siempre somos conscientes de lo valioso que es el parecer individual en cualquier tipo de encuesta.

No digo más, seguiré remando contra corriente.