Sondeo sobre la biblioteca GH Freebrary

[Casimiro Notevi]

Pienso que el mayor problema es el desconocimiento, es muy difícil llegar hasta el usuario final, ¿qué es lo que conoce casi todo el mundo?, quantumgrid, tms y no mucho más. Se necesita mucho tiempo para ir calando entre los potenciales usuarios, o mucho dinero para una gran campaña de publicidad.

[[Al González]]

Visitas: 1281
Votos: 7

[mamcx]

Empezado por Casimiro Notevi

Pienso que el mayor problema es el desconocimiento, es muy difícil llegar hasta el usuario final, ¿qué es lo que conoce casi todo el mundo?

Otra cosa que no ayuda: Esto esta hosteado en un foro. Osea, cuando un programador (hoy dia) piensa: Voy a buscar una biblioteca, debe estar en un foro (no!).

Hoy dia, el codigo open source esta en github o en bitbucket y en menor medida en google code. No solo porque sea una opcion popular, es porque ademas, permite visualizar el codigo fuente sin descargar, es sobre un VCS, tiene wiki, forma de reportar los bugs, y es una indicacion que el autor esta al dia en como se hace las cosas.

Personalmente, si un codigo esta en un .zip, tiene que ser algo MUY deseable para ponerme a la tarea de bajarlo.

P.D: Y si es importante la documentacion, en https://readthedocs.org/

[[nlsgarcia]]

AL Gonzalez,

Empezado por AL Gonzalez

...Desafortunadamente se han hecho efectivas muy pocas de aquellas alzadas de mano con las que alguna vez se dijo: "enhorabuena, prometo descargarla, echar una mirada y comentarte mis impresiones"...

En mi opinión personal, el trabajo que has realizado con la librería GHFreebrary, es muy elogiable y realmente te felicito por tu esfuerzo en ayudar a otros programadores de Delphi con tus conocimientos y experiencia

Para probar la librería baje la versión GHFreebrary_Delphi7_20140111 y revise a nivel general su contenido y tengo las siguientes dudas:

1- ¿Donde esta la documentación de la librería en formato PDF, CHM, HTML o cualquier otro formato que sirva de referencia al programador?

2- ¿Donde esta el código de ejemplo de la librería que ilustre el uso de sus diferentes clases y funciones?

Sin documentación y ejemplos se dificulta enormemente el uso de algo tan extenso como una librería, entre mayor sea la documentación, código de ejemplos y screenshot : Mayor sera la probabilidad de difusión y uso de cualquier producto de software orientado a la programación.

Empezado por AL Gonzalez

...Para la documentación he intentado seguir un esquema similar al de las clásicas ayudas de Delphi y la API de Windows que en mi opinión son todo menos pobres. En las cuales se presenta: una descripción corta, la declaración del elemento, una descripción general, la descripción de cada uno de los parámetros, las notas u observaciones y algunos ejemplos...

Pregunto : ¿Donde esta? , ciertamente hay un link que hace referencia a la documentación : Manual de referencia de GH Freebrary, pero creo que es un trabajo en proceso

Empezado por AL Gonzalez

...aunque a veces me lleva eternos minutos redactar unas cuantas líneas que le parezcan aceptables a quienes hablan ese idioma...todos los comentarios que van en el código fuente los escribo en inglés...considero que lo anterior es algo que debería procurarse con cualquier biblioteca de programación de uso público...

Te sugiero hacer toda la documentación interna y externa de la librería en español y luego cuando ya este terminada, pasarla en una segunda fase al ingles, creo que de esta forma sera más fácil y eficiente

Empezado por mamcx

...el código open source esta en github o en bitbucket y en menor medida en google code. No solo porque sea una opcion popular, es porque ademas, permite visualizar el código fuente sin descargar, es sobre un VCS, tiene wiki, forma de reportar los bugs...

Ciertamente, no todo el código open source de internet este en dichos repositorios, sin embargo son una opción a considerar si quieres ampliar el alcance de GHFreebrary.

Empezado por mamcx

...es importante la documentacion...

En Conclusión : Sin una adecuada documentación como referencia y sin código de ejemplos que ilustren las diferentes funciones y clases, el uso de GHFreebrary a nivel general sera un poco complejo

Espero sea útil

Nelson.

[[Al González]]

Gracias por sus comentarios Nelson, Mario.

El 85% de lo que han dicho lo tengo bien sabido y es algo con lo que concuerdo. El otro 15% lo encuentro mal concebido. Supongo entonces que ustedes votaron por la última opción (al menos).

El espacio en BerliOS lo tengo reservado desde hace un par de años; vamos a ver si sacamos algo de financiamiento para ponerme a organizar las cosas. Aún no es seguro, pero estoy en charlas con una empresa para comenzar a trabajar en ella, tras cuatro años buscando empleo. Eso podría cambiar un poco el panorama.

Por otro lado, les recuerdo que ahí están las opciones para quienes no han votado. Creo que voy a alegrarme mucho el día que alguien se anime a probar concienzudamente alguna rutina o clase, se esfuerce un poquito en entender el código, si gusta ayude a documentar y, sobre todo, comencemos a generar retroalimentación en el foro, que para eso es, ¿no?.

Yo veo todo lo que concierne a esta biblioteca "en proceso" permanente, pues siempre habrá software que construir y parte de ese software podría quedar dentro de ella. Sé que hay gente que puede apoyar el proyecto más allá de la mera crítica y por alguna razón que desconozco no se atreve a decir nada.

También sé que todos juntos nos hemos encargado de forjar un mundo lo suficientemente difícil para no sentirnos inclinados a echar una mano generosa a alguien que apenas conocemos. Si alguno es la excepción y ha sabido encontrarle a su vida más momentos felices que infelices, ese es el tipo de persona que puede ayudar más.

Mario: No todo en la vida es marketing.

Nelson: Lo que falta (más documentación, más ejemplos, más pantallas) está ahí: en tu teclado.

De nuevo, gracias a ambos por las buenas intenciones.

Y esperemos no se olvide que esto es una simple encuesta sobre un pequeño tema, de varios, de una biblioteca libre que de momento no cuenta con muchas manos amigas. Eso sí, la crítica siempre será bienvenida.

Saludos cordiales.

[[nlsgarcia]]

Al González,

Empezado por Al González

...El 85% de lo que han dicho lo tengo bien sabido y es algo con lo que concuerdo. El otro 15% lo encuentro mal concebido...

Empezado por AzidRain

...Sin embargo lo que creo que le faltaría para redondearla es documentar un poco cada función y procedimiento...

Empezado por fjcg02

...ya he comentado otras veces que bajo mi punto de vista falta una pequeña aplicación que ponga en práctica todas las piezas del puzzle, bien comentada, sin que sea una superaplicación, sino que exponga de forma general el motivo de utilizar así las piezas...

Empezado por Ñuño Martínez

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

Empezado por mamcx

...es importante la documentacion...

Empezado por nlsgarcia

...Sin documentación y ejemplos se dificulta enormemente el uso de algo tan extenso como una librería...

Empezado por Al González

...Lo que falta (más documentación, más ejemplos, más pantallas) está ahí: en tu teclado...

Empezado por Al González

...Supongo entonces que ustedes votaron por la última opción...

En mi opinión personal, se puede agregar otra opción : Falta Documentación y Código de Ejemplos

Empezado por Al González

...Eso sí, la crítica siempre será bienvenida...

Más que crítica constructiva, es una recomendación práctica

Espero sea útil

Nelson.

[[Al González]]

Gracias Nelson, sin duda hay mucho por hacer. Aprecio que te des el tiempo para intentar ayudar.

[[Al González]]

Bueno, cerrada la encuesta, no resta más que agradecer a los que participaron en ella.

Les adelanto que he estado trabajando mucho en la edición para XE5, pues en mi trabajo actual está resultando una pieza fundamental. En ésta he creado varias clases nuevas y extendido otras, incluyendo derivaciones de las nativas TDictionary y TList genéricas, dotándolas con funcionalidad adicional. También trabajé bastante en asuntos de RTTI extendida y me aventuré en crear un mecanismo universal de observaciones (patrón observador y cosillas de ese estilo).

Creo que a más tardar en marzo quedaría lista para ponerla a disposición del público.

Saludos.