Author Topic: a vueltas con lo de la documentación  (Read 4653 times)

Offline bosch

  • PixInsight Addict
  • ***
  • Posts: 123
a vueltas con lo de la documentación
« on: 2009 November 08 09:44:16 »
Hola, aunque éste es un tema que ya ha sido tratado muchas veces, me gustaría en esta ocasión hacer una propuesta/petición.

Como ya se ha dicho en varias ocasiones, información sobre cómo funciona PI hay e incluso yo me atrevería a decir que hay mucha. Pero también es cierto que podríamos concluir que ésta se encuentra un tanto dispersa. Casi todos los módulos o incluso scripts han sido explicados dentro de algún tutorial, ejemplo de procesamiento, video tutorial o incluso se han explicado dentro de algún post de presentación al público cuando se creó.

Por otra parte se ha dicho en alguna ocasión que el típico "libro de instrucciones" en el caso de PI, por su carácter modular, no sería eficaz. Parece que se ha ido apostando por los videotutoriales como herramienta docente por el ahorro que representan. Ya sabeis, aquello de que una imagen vale más que mil palabras. (por cierto, muy buenos incluso para los que no dominamos el inglés)

Bueno, ¡al grano!.
No se si sería buena idea que del mismo modo que cuando se señala con el puntero un parámetro aparece de forma flotante un ligera explicación de su función, pudieran aparecer los enlaces donde se explica el funcionamiento de un módulo cuando se apunta éste con el puntero.

Obviamente ésto conllevaría hacer una recopilación previa de cualquier video/ejemplo de proceado/tutorial y dejarlo un tanto ordenado en un mismo lugar para que los enlaces no se perdieran a la mínima.

No sé si me explico.

Os pondré un ejemplo.

El otro día resulta que quiero usar uno de los nuevos módulos, concretamente el BackgroundNeutralization. Pues resulta que en ningún videotutorial, ejemplo de procesado o tutorial aparece cómo funciona éste. Buscando buscando, veo que Juan Conejero hace una explicación de él en el post que anuncia la versión 1.5 (perdonadme si no está en otra parte también y no lo he encontrado pues se trata simplemente "a modo de ejemplo").
Pues creo yo que sería buena idea que cuando se pase el cursor encima del módulo aparezca un menú contextual (o haciendo clik al botón derecho) con un enlace hacia http://pixinsight.com/forum/index.php?topic=1105.0
 que es dónde Juan nos enseña cómo funciona. Ello obligaría que ese post no se moviera de lugar para que el enlace no se perdiera o incluso meterlo junto a otros en un lugar donde se quedara guardado "para siempre".

Quizá pueda parecer una soberana tontería, pero eso ahorraría mucho tiempo cuando uno busca información de cómo funciona tal o cual aplicación.

Un saludo

Offline Carlos Milovic

  • PTeam Member
  • PixInsight Jedi Master
  • ******
  • Posts: 2172
  • Join the dark side... we have cookies
    • http://www.astrophoto.cl
Re: a vueltas con lo de la documentación
« Reply #1 on: 2009 November 08 12:23:51 »
Creo que eso es lo que pretende hacer la wiki...
http://wiki.pixinsight.com

Regards,

Carlos Milovic F.
--------------------------------
PixInsight Project Developer
http://www.pixinsight.com

Offline bosch

  • PixInsight Addict
  • ***
  • Posts: 123
Re: a vueltas con lo de la documentación
« Reply #2 on: 2009 November 08 15:24:13 »
OK, gracias Carlos pues no me había pasado por ahí. Luego sólo faltaría un enlace hacia la wiki desde el programa mismo.