[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