[Jderobot] Refactorizaci�n del mediawiki
Borja Mon Serrano
borjamonserrano en gmail.com
Mar Nov 19 16:45:04 CET 2013
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
More information about the Jde-developers
mailing list