Actualización y mejora de la documentación de la herramienta de código libre Tematres y en idiomas español e inglés

Gabriel Hernán Kulevicius

Funding Area: Capacity building / Construcción de capacidad

Problem Statement: Los vocabularios controlados constituyen un tipo específico de sistema de organización del conocimiento (SOC), delimitan y formalizan un dominio estableciendo los términos que lo conforman, el alcance conceptual de los términos y las relaciones que los articulan. Se trata de dispositivos de mediación social que basan su productividad y agencia en su capacidad para referenciar de manera no ambigua un conjunto de referentes en el contexto de un dominio y articularlos a través de una una red coherente de relaciones léxico-semánticas. Tematres es una herramienta de código libre para gestión de representaciones formales del conocimiento. Tematres es actualmente referenciado como solución por el directorio global de vocabularios más importante: https://bartoc.org/ Al ser Tematres mantenido sin financiamiento más que las horas dedicadas ad honorem por sus creadores, en particular Diego Ferreyra, la documentación se atrasa respecto de los desarrollos no solo en el idioma nativo que es el español, sino también en otros idiomas como ser el portugues y el inglés.

Proposed Activities: Se propone con este financiamiento actualizar la documentación y centralizar en un espacio formal y oficial de Tematres en las cuales se vinculan desde la página de inicio de la herramienta https://vocabularyserver.com/web/ Y adicionalmente el repositorio github del mismo https://github.com/tematres/TemaTres-Vocabulary-Server/ Se seleccionará en el proceso una herramienta como ser Readthedocs, GitBook o similar. Actualmente la documentación de la herramienta se encuentra en https://vocabularyserver.com/web/items/browse?collection=3 Pero la misma no tiene una formulación correcta ya que se forma por diferentes manuales realizados por la comunidad y compartidos con los desarrolladores. Adicionalmente no corresponden a la última versión de Tematres y nuevas funcionalidades no se ven expresadas en las mismas. Como punto importante, la mayoría se encuentra principalmente en idioma español y portugués, por ser Brasil un país de gran uso de la herramienta (oficialmente propuesta por el Gobierno Federal - https://www.gov.br/ibict/pt-br/assuntos/tecnologias-para-a-informacao/tematres) y el idioma inglés que nuclea a la mayoría de los países no se encuentra representado en esta documentación. Se propone un cronograma de 90 días para la actualización de la documentación de la herramienta Tematres versión 3.4.3 con las tareas comprendidas en el siguiente listado: Selección de la herramienta de documentación en línea Instalación de la herramienta de documentación en línea, configuración, aprendizaje de uso a nivel usuario. Definición de la estructura de la documentación Documentación de sección de instalación en español Documentación de sección de administración y configuración en español Documentación de sección de editor en español Traducción al inglés de las secciones desde español La herramienta de documentación permitirá un mantenimiento más dinámico de los cambios al realizarse nuevas versiones de la herramienta, agregar funcionalidades, y buscar en un futuro ayuda para versiones específicas.

Openness: Para nosotros como desarrolladores de Tematres sería ideal la integración del mismo al Catalog of Open Infrastructure Services (COIs) no solo para exponer estos desarrollos sino también Tematres como herramienta la cual es hoy un estándar de código libre para la gestión de vocabularios controlados. La intención en esta mejora es profundizar el uso de vocabularios controlados por la comunidad a partir de la mejora de la documentación de la misma. Adicionalmente nos encontramos en diferentes canales de publicación de tecnologías en el ámbito bibliotecológico en idioma español los cuales serán canales de exposición de estas nuevas soluciones para la comunidad. Como expertos relacionados también al mundo académico, participamos anualmente de diferentes exposiciones en seminarios y congresos específicos donde exponemos estas soluciones para su promoción. Para las tareas de Traducción adicionalmente se deberá agregar un revisor de la ayuda en idioma inglés como profesional específico además del equipo que propone realizar las estas tareas del presente documento.

Challenges: El mayor desafío es la correcta selección de la herramienta de documentación que cumple con las expectativas y facilidad de uso, y se integre con fluidez a los procesos de mantenimiento de la herramienta de código libre, ya que una vez seleccionado y aprendido su uso es un costo importante haber hecho una mala decisión al respecto y tener que reemplazarla por alguna nueva por cualquier motivo (uso, costos, funcionalidades, etc).

Neglectedness: La evolución de Tematres y sus integraciones en muchos casos de su historia de desarrollo fueron financiadas por solicitudes de funcionalidades en proyectos específicos. En el caso de estas tareas de documentación particulares no fueron anteriormente financiadas ni pudieron desarrollarse con la importancia y dedicación que merece por el equipo interno como evolución del producto. El financiamiento a la misma nos permite levantar prioridad y tener el sustento necesario para realizarla de forma correcta y mantenible en el tiempo.

Success: El éxito se mide con la finalización de las tareas y la publicación de las novedades en la lista de comunidades que utilizan Tematres. La expectativa es conseguir ampliar el equipo de documentación a nuevos idiomas (en particular Portugués) una vez que se encuentren estas tareas finalizadas.

Total Budget: 5940

Affiliations: Ninguna en particular, la misma es una propuesta de equipo para la formalización de la documentación de la herramienta Tematres en idiomas español e inglé

LMIE Carveout: El proyecto se encuentra principalmente asociado a la localidad de Ciudad Autónoma de Buenos Aires, Argentina. País que no pertenece a LMIE

Team Skills: Diego Ferreyra https://www.linkedin.com/in/perfildiegoferreyra Es el autor de la herramienta Tematres y desarrollador original de la misma así como dueño de su patente. Con formación en Bibliotecología, Linguista y desarrollador PHP Gabriel Kulevicius https://www.linkedin.com/in/gabrielkulevicius/ Es Analista Universitario en Computación por la UBA, con experiencia de más de 20 años en la implementación de aplicaciones de código libre en PHP, principalmente CMSs y LMSs.

How Did You Hear About This Call: Word of mouth (e.g. conversations and emails from IOI staff, friends, colleagues, etc.) / Boca a boca (por ejemplo, conversaciones y correos electrónicos del personal del IOI, amigos, colegas, etc.)

Submission Number: 169