[Jderobot] Refactorización del mediawiki

[Borja Mon Serrano]

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.
------------ próxima parte ------------
Se ha borrado un adjunto en formato HTML...
URL: http://gsyc.escet.urjc.es/pipermail/jde-developers/attachments/20131119/8154f79c/attachment.htm