[pyar] Necesito Feedback para herramienta de Documentacion

[Diego Sarmentero]

Gracias por el feedback!

El día 5 de noviembre de 2013 14:05, Nicolás Pace <nicopace en gmail.com> escribió:
>
>
>
> 2013/11/5 Andres Riancho <andres.riancho en gmail.com>
>>
>> Otra cosa util: Un search. Fijate el que esta implementado en sphinx,
>> que es JS puro y podria ser facilmente adaptado.
>
>
> Nikola viene con uno, Tipue Search:
> http://getnikola.com/handbook.html#local-search
>
>
>>
>>
>> 2013/11/5 Andres Riancho <andres.riancho en gmail.com>:
>> > 2013/11/5 Diego Sarmentero <diego.sarmentero en gmail.com>:
>> >> Hola gente, hace un tiempo hice este proyecto motivado por algo que
>> >> habia surgido en el PyCamp del 2012:
>> >>
>> >> https://github.com/diegosarmentero/documentor
>> >>
>> >> El tema es que desde que hice eso, medio que quedo ahi, y me gustaria
>> >> saber por ahi de gente que haya usado mas este tipo de herramientas
>> >> que cosas les parece que seria bueno mejorar/agregar.
>> >>
>> >> Por ejemplo: estaria bueno que al generar la doc te corriera los tests
>> >> y te mostrara una pagina con el coverage que tiene actualmente el
>> >> proyecto??
>> >
>> > No creo que sea beneficioso, ya hay otras tools que hacen eso. Yo me
>> > enfocaria en la funcionalidad principal de la tool.
>> >
>> >> Que te liste archivos que no sean pep8 compatible?
>> >
>> > Idem
>> >
>> >> Mostrar alguna representacion grafica del proyecto tipo diagrama de
>> >> clases/modulos?
>> >
>> > +1
>> >
>> >> etc etc
>> >>
>> >> Cualquier sugerencia es bienvenida.
>> >
>> > Yo buscaria cuales son las funcionalidades que ofrecen otras tools
>> > (doxygen?) e intentaría adaptarlas a python
>> >
>> > Algo que quizás se me ocurre es poder utilizar markdown dentro de los
>> > comentarios de documentacion del codigo, que luego sea rendereado a
>> > HTML cuando generas la documentacion.
>> >
>> >> Saludos
>> >>
>> >> --
>> >> Diego Sarmentero
>> >>
>> >> Website: http://diegosarmentero.org
>> >> Twitter: http://twitter.com/diegosarmentero
>> >> _______________________________________________
>> >> pyar mailing list pyar en python.org.ar
>> >> http://listas.python.org.ar/listinfo/pyar
>> >>
>> >> PyAr - Python Argentina - Sitio web: http://www.python.org.ar/
>> >>
>> >> La lista de PyAr esta Hosteada en USLA - Usuarios de Software Libre de
>> >> Argentina - http://www.usla.org.ar
>> >
>> >
>> >
>> > --
>> > Andrés Riancho
>> > Project Leader at w3af - http://w3af.org/
>> > Web Application Attack and Audit Framework
>> > Twitter: @w3af
>> > GPG: 0x93C344F3
>>
>>
>>
>> --
>> Andrés Riancho
>> Project Leader at w3af - http://w3af.org/
>> Web Application Attack and Audit Framework
>> Twitter: @w3af
>> GPG: 0x93C344F3
>> _______________________________________________
>> pyar mailing list pyar en python.org.ar
>> http://listas.python.org.ar/listinfo/pyar
>>
>> PyAr - Python Argentina - Sitio web: http://www.python.org.ar/
>>
>> La lista de PyAr esta Hosteada en USLA - Usuarios de Software Libre de
>> Argentina - http://www.usla.org.ar
>
>
>
>
> --
> Ing. Nicolás Pace
> http://www.linkedin.com/in/nickar/
> http://www.unixono.com.ar/
>
> _______________________________________________
> pyar mailing list pyar en python.org.ar
> http://listas.python.org.ar/listinfo/pyar
>
> PyAr - Python Argentina - Sitio web: http://www.python.org.ar/
>
> La lista de PyAr esta Hosteada en USLA - Usuarios de Software Libre de
> Argentina - http://www.usla.org.ar



-- 
Diego Sarmentero

Website: http://diegosarmentero.org
Twitter: http://twitter.com/diegosarmentero