[Jderobot] Refactorización del mediawiki

edgar barrero ea.barrero en hotmail.com
Mar Nov 19 18:15:44 CET 2013


Hola Borja,

Lo primero agradecerte toda la ayuda que nos estas prestando, aunque Laura es la que va abriendo brecha en esto de introrobot yo voy al rebufo a ver si conseguimos que funcione.
Me parece muy bien que se cambie el mediawiki porque en la instalación de Jderobot puede ser más clara. El problema es que lo he intentado tantas veces hasta que ha funcionado que al final no tengo claros los pasos ni que librerías eran necesarias y cuales no. Prometo que cuando tenga un poco más de experiencia ayudaré a mejorar el tutorial de instalación.
Siento no poder ayudar mucho más.
Un saludo.

Edgar Barrero
Date: Tue, 19 Nov 2013 16:45:04 +0100
From: borjamonserrano en gmail.com
To: jderobot en gsyc.es
Subject: [Jderobot] Refactorización del mediawiki

Hola a todos,

Le estaba dando vueltas 
pensando en cómo podría quedar el mediawiki para que todo tuviese una 
estructura un poco más lógica y me ha salido esto, a ver qué os parece.


Lo primero de todo, en la página principal, cambiar de orden 
las dependencias y el proceso de instalación. Si lo que queremos es 
instalar jderobot, lo suyo es que primero nos instalemos las 
dependencias, ya que de otra forma no podremos instalar jderobot.


En la parte de dependencias, ponerlas todas ahí. No puede
 ser que si queremos instalar OpenCV, que es una dependencia que tienen 
muchos componentes de jderobot, tengamos que acceder a otra página del 
mediawiki. Lo mismo ocurre con ICE, por ejemplo, cuando aquí es todavía 
más evidente que es muy importante para el proyecto... Y lo peor de todo
 es que ICE está ahí medio escondido, que a poco que vayas rapidillo te 
lo saltas y se te olvida instalarlo.


En el hilo de lo anterior, no entiendo por qué si hay una
 parte que "Instalación de dependencias" se esté metiendo también 
"Desarrollar con esta dependencia". No hay más que mirar la parte de 
OpenCV de la que he hablado antes para comprobar esto. Lo suyo es que si
 son dependencias, son dependencias, y si queremos desarrollar con ellas
 ya nos preocuparemos después de mirarlo. Creo que aquí la división 
debería de ser no tanto por el paquete/biblioteca que se necesite y 
meter todo ahí, sino más bien por funcionalidad (si queremos instalarlo,
 si queremos desarrollar con ello, etc).


La dependencia con GearBox ya no existe, ¿verdad? Tampoco
 se hace nada con Player/Stage ya, solo con Gazebo (en cuanto a 
simuladores hablo, claro). Creo que esto se podría eliminar.

Como
 ya he comentado en otro correo, se eliminará la tabla de dependencias. 
Todas las dependencias ya quedan lo suficientemente claras, bien en el 
apartado de dependencias como tal, bien cuando vas a compilar y te las 
dice el bueno de cmake :)


Por otra parte, existen dos secciones diferenciadas y que
 a priori alguien nuevo no sabría muy bien cómo identificar. Me refiero a
 drivers y tools. De acuerdo que tenemos componentes que son drivers y 
otros que son herramientas, pero alguien que se haya descargado de 
nuevas el repositorio lo único que verá, en todo caso, son componentes, 
interfaces y bibliotecas, pero nada de drivers y herramientas. Creo que 
esto se podría poner bajo un mismo paraguas (componentes) y luego 
explicar que hay diferentes tipos de componentes.


Además, también está el tema de que las explicaciones de 
cómo hacer funcionar los componentes está muy dispersa. En "Running 
JDERobot" hay un poco (desactualizada también, porque se habla de Player
 y playerServer) pero luego también nos podemos encontrar algunas 
explicaciones en drivers o en tools. Creo que en todo caso en esas 
secciones se tiene que explicar cómo funcionan y cómo lanzarlas, pero la
 explicación de cómo hacer correr cameraserver+cameraviewer o 
gazebo+plugin+introrob debería de ir en el Running JDERobot. En cambio, 
en esta sección de Running JDERobot no debería de ir la explicación de 
cómo crear un interfaz de ICE o cómo programar para OpenCV, eso debería 
de ir en otra sección dedicada a ello (como "Desarrolla con... 
OpenCV/ICE/PointCloud/etc").


Y así de primeras no se me ocurren más cosas. Tampoco 
quiero sentar cátedra, lo que me gustaría es hablar sobre ello entre 
todos (los nuevos también, por favor... De hecho, más que "también", me 
gustaría decir "sobre todo") y que se llegue a un acuerdo sobre cómo 
mejorar la estructura del mediawiki, que a fin de cuentas es lo primero 
que nos encontramos cuando entramos nuevos a jderobot, ¿no? :)


Perdonad el tocho. Un saludo,

Borja.

_______________________________________________
Jde-developers mailing list
Jde-developers en gsyc.es
http://gsyc.escet.urjc.es/cgi-bin/mailman/listinfo/jde-developers 		 	   		  
------------ próxima parte ------------
Se ha borrado un adjunto en formato HTML...
URL: http://gsyc.escet.urjc.es/pipermail/jde-developers/attachments/20131119/c456a98d/attachment.htm 


More information about the Jde-developers mailing list