Merge: Mejorar y completar documentación de Coderic

Author: cursoragent

ROOT/modules/ROOT/pages/CONTRIBUTING.adoc

@@ -1,3 +1,170 @@
 = Contribuyendo
 
-TODO
+?Gracias por tu inter?s en contribuir a Coderic! Esta gu?a te ayudar? a entender c?mo puedes participar y hacer contribuciones significativas a nuestros proyectos.
+
+== C?mo contribuir
+
+Hay muchas formas de contribuir a Coderic, y todas son valiosas:
+
+=== Reportar problemas
+
+Si encuentras un bug o tienes una sugerencia:
+
+. Busca si ya existe un issue relacionado
+. Si no existe, crea un nuevo issue en el repositorio correspondiente
+. Proporciona informaci?n detallada: pasos para reproducir, comportamiento esperado vs. actual
+. Incluye informaci?n del entorno: versi?n, sistema operativo, etc.
+
+=== Mejorar documentaci?n
+
+La documentaci?n siempre puede mejorar:
+
+* Corrige errores tipogr?ficos o gramaticales
+* Mejora la claridad de las explicaciones
+* Agrega ejemplos o casos de uso
+* Traduce contenido a otros idiomas
+* Agrega documentaci?n faltante
+
+=== Contribuir c?digo
+
+Para contribuir c?digo:
+
+. Fork el repositorio
+. Crea una rama para tu feature (`git checkout -b feature/nueva-funcionalidad`)
+. Realiza tus cambios y commit (`git commit -m 'Agrega nueva funcionalidad'`)
+. Push a tu fork (`git push origin feature/nueva-funcionalidad`)
+. Abre un Pull Request
+
+=== Mejorar dise?o
+
+Si te interesa el dise?o:
+
+* Mejora interfaces de usuario
+* Crea assets gr?ficos
+* Optimiza experiencias de usuario
+* Dise?a logos o material gr?fico
+
+=== Organizar eventos
+
+Ayuda a organizar:
+
+* Meetups y eventos locales
+* Conferencias y talleres
+* Sesiones de hackathon
+* Webinars y charlas t?cnicas
+
+== Gu?as de contribuci?n
+
+=== C?digo de conducta
+
+Todas las contribuciones deben seguir nuestro xref:CODE_OF_CONDUCT.adoc[c?digo de conducta]. Mant?n un ambiente respetuoso y acogedor para todos.
+
+=== Est?ndares de c?digo
+
+* *Linting*: El c?digo debe pasar las verificaciones de linting
+* *Tests*: Agrega tests para nuevas funcionalidades
+* *Documentaci?n*: Documenta funciones y APIs p?blicas
+* *Commits*: Usa mensajes de commit claros y descriptivos
+
+=== Proceso de Pull Request
+
+1. *Describe tu cambio*: Explica qu? y por qu? en la descripci?n del PR
+2. *Tests*: Aseg?rate de que todos los tests pasen
+3. *Documentaci?n*: Actualiza la documentaci?n si es necesario
+4. *Revisi?n*: Espera la revisi?n de los mantenedores
+5. *Mejoras*: Responde a los comentarios y realiza ajustes si es necesario
+
+=== Branches y versionado
+
+* *main/master*: Rama principal, siempre estable
+* *develop*: Rama de desarrollo activo
+* *feature/*: Nuevas funcionalidades
+* *bugfix/*: Correcciones de bugs
+* *hotfix/*: Correcciones urgentes
+
+== Tipos de contribuciones
+
+=== Peque?as contribuciones
+
+Para cambios peque?os (typos, mejoras menores):
+
+. Puedes editar directamente en GitHub
+. El cambio ser? revisado y mergeado r?pidamente
+
+=== Contribuciones mayores
+
+Para cambios grandes:
+
+. Abre un issue primero para discutir el cambio
+. Espera feedback antes de comenzar a trabajar
+. Sigue el proceso completo de Pull Request
+
+=== Nuevas caracter?sticas
+
+Para proponer nuevas caracter?sticas:
+
+1. Abre un issue con la etiqueta "enhancement"
+2. Describe la caracter?stica y su justificaci?n
+3. Discute con la comunidad
+4. Si se aprueba, procede con el desarrollo
+
+== Herramientas y recursos
+
+=== Entorno de desarrollo
+
+* *Git*: Control de versiones
+* *Editor*: Usa el editor que prefieras
+* *Testing*: Herramientas de testing del proyecto
+* *Documentaci?n*: Herramientas de documentaci?n local
+
+=== Comunicaci?n
+
+* *GitHub Issues*: Para bugs y discusiones t?cnicas
+* *GitHub Discussions*: Para preguntas y discusiones generales
+* *Email*: latam@coderic.org para temas no t?cnicos
+
+=== Recursos de aprendizaje
+
+* Documentaci?n del proyecto
+* C?digo existente como referencia
+* Comunidad para hacer preguntas
+
+== Reconocimiento
+
+Agradecemos todas las contribuciones. Los contribuidores son reconocidos en:
+
+* README del proyecto
+* Releases y changelogs
+* Documentaci?n de contribuidores
+* Eventos y comunicaciones de la comunidad
+
+== Preguntas frecuentes
+
+=== ?Necesito ser un experto para contribuir?
+
+No. Las contribuciones de todos los niveles son bienvenidas. Incluso reportar bugs o mejorar documentaci?n es valioso.
+
+=== ?C?mo elijo en qu? trabajar?
+
+Puedes:
+* Revisar issues etiquetados como "good first issue"
+* Preguntar en Discussions qu? necesita ayuda
+* Trabajar en algo que te interese personalmente
+
+=== ?Qu? pasa si mi PR es rechazado?
+
+No te desanimes. El feedback es para mejorar. Revisa los comentarios, haz ajustes y vuelve a intentar.
+
+=== ?Puedo contribuir sin c?digo?
+
+?Absolutamente! Hay muchas formas no t?cnicas de contribuir: documentaci?n, dise?o, organizaci?n de eventos, traducci?n, etc.
+
+== Contacto
+
+Si tienes preguntas sobre c?mo contribuir:
+
+* *Email*: latam@coderic.org
+* *GitHub Discussions*: https://github.com/CodericLatam/docs/discussions
+* *Issues*: https://github.com/CodericLatam/docs/issues
+
+?Esperamos tus contribuciones!

ROOT/modules/ROOT/pages/history.adoc

@@ -2,29 +2,29 @@
 :figure-caption!:
 
 == Antecedentes
-Coderic fué concebido el 6 de febrero de 2002 por Eduardo Bravo, José Cárdenas y Neftalí Yagua inicialmente se llamaría Impreelectrón la cuál se dedicaría a hacer circuitos electrónicos armables, como juegos para aficionados a la electrónica, en un principio, en su mayoría no conociamos personas que tuvieran la capacitación mínima para hacer uso de tales circuitos así que proyectamos a crear algo que pudiera ofrecer capacitación en áreas de electrónica, electricidad y robótica.
+Coderic fue concebido el 6 de febrero de 2002 por Eduardo Bravo, José Cárdenas y Neftalí Yagua inicialmente se llamaría Impreelectrón la cuál se dedicaría a hacer circuitos electrónicos armables, como juegos para aficionados a la electrónica, en un principio, en su mayoría no conociamos personas que tuvieran la capacitación mínima para hacer uso de tales circuitos así que proyectamos a crear algo que pudiera ofrecer capacitación en áreas de electrónica, electricidad y robótica.
 
 video::-KIGsc-qLMM[youtube, width="854",height="480"]
 
 == Fundación
 
-En Marzo de 2003 Neftalí Yagua planificó lo que sería el nuevo nombre de la organización inspirado en el nombre de un proyecto de inteligencia conversacional llamado Decabyte, el proyecto era una aplicación que usaba el Servicio de mensajería de Microsoft y recursos del buscador de Google, el sistema ubicaba resultados basados en la palabra inicial que serviría de comando para la busqueda de contenidos en internet. Ideando un nombre corto y fácil de recordar se proyectó hacer un segundo robot llamado Erick que sería de código abierto, sí que se realizó un nombre compuesto basado en CODE de código en inglés y Erick siendo inicialmente Coderick la K se eliminó por ser poco práctico al escribir el nombre y dificil de recordar simplificando como Coderic más tarde al consolidarse la idea de la organización se buscó un significado más corporativo con la intención de justificar sus siglas llamándose Compañia Orientada al Desarrollo Estratégido de Recursos Informáticos Comerciales y También Compañia Orientada al Desarrollo Estratégico de Recursos de Información y Capacitación, quedando el primero por votación unánime. 
+En marzo de 2003 Neftalí Yagua planificó lo que sería el nuevo nombre de la organización inspirado en el nombre de un proyecto de inteligencia conversacional llamado Decabyte, el proyecto era una aplicación que usaba el Servicio de mensajería de Microsoft y recursos del buscador de Google, el sistema ubicaba resultados basados en la palabra inicial que serviría de comando para la búsqueda de contenidos en internet. Ideando un nombre corto y fácil de recordar se proyectó hacer un segundo robot llamado Erick que sería de código abierto, sí que se realizó un nombre compuesto basado en CODE de código en inglés y Erick siendo inicialmente Coderick la K se eliminó por ser poco práctico al escribir el nombre y difícil de recordar simplificando como Coderic más tarde al consolidarse la idea de la organización se buscó un significado más corporativo con la intención de justificar sus siglas llamándose Compañía Orientada al Desarrollo Estratégico de Recursos Informáticos Comerciales y También Compañía Orientada al Desarrollo Estratégico de Recursos de Información y Capacitación, quedando el primero por votación unánime. 
 En la actualidad se conoce como *Corporación Orientada al Desarrollo Estratégico de Recursos de Información Comercial*
 
 .Prototipo de Modelado 3D en el que inspiró al proyecto Decabyte
 image::decabyte.jpg["Prototipo de Modelado 3D en el que inspiró al proyecto Decabyte"]
 
-== Trayectoría
+== Trayectoria
 
-Coderic ha sido planificado para que sea un centro de capacitación, ese es el objetivo sobre el cuál fue concebido, sin embargo, por causa de la falta de capital para el proyecto inicial, se tomó la iniciativa de dar cursos gratuitos en sitios clandestinos, resultó un éxito tomando en cuenta que muchos de los que iniciaron en Coderic hoy día viven de lo que aprendieron en la organización, Coderic disponía de la radio y el chat que servia para atraer usuarios que tuvieran interés en aprender, lo cuál exitosamente cumplió sus objetivos, he incluso tuvo un foro de opinión, el cuál no fué tan bueno como los anteriores, los usuarios de Coderic no entendían el concepto de Foro, más tarde Coderic creció como organización, hasta el punto de que empresas como Lorini, Servicios Hosting, *CyberVentas* e *iCADServers* tuvieron la iniciativa de apoyar y patrocinar los servidores para la radio, el chat y las páginas web de Coderic y sus miembros, su patrocinio exigía una responsabilidad, la responsabilidad de promoverles a través de los medios de Coderic (la radio y el chat) lamentablemente el publico no era un publico orientado al consumo de tales servicios así que no se llenaron las espectativas de tales compañías.
+Coderic ha sido planificado para que sea un centro de capacitación, ese es el objetivo sobre el cuál fue concebido, sin embargo, por causa de la falta de capital para el proyecto inicial, se tomó la iniciativa de dar cursos gratuitos en sitios clandestinos, resultó un éxito tomando en cuenta que muchos de los que iniciaron en Coderic hoy día viven de lo que aprendieron en la organización, Coderic disponía de la radio y el chat que servía para atraer usuarios que tuvieran interés en aprender, lo cual exitosamente cumplió sus objetivos, e incluso tuvo un foro de opinión, el cual no fue tan bueno como los anteriores, los usuarios de Coderic no entendían el concepto de Foro, más tarde Coderic creció como organización, hasta el punto de que empresas como Lorini, Servicios Hosting, *CyberVentas* e *iCADServers* tuvieron la iniciativa de apoyar y patrocinar los servidores para la radio, el chat y las páginas web de Coderic y sus miembros, su patrocinio exigía una responsabilidad, la responsabilidad de promoverles a través de los medios de Coderic (la radio y el chat) lamentablemente el público no era un público orientado al consumo de tales servicios así que no se llenaron las expectativas de tales compañías.
 
-Al intentar hacer cambios en Coderic para dejar de ser un grupo aficionado para convertirlo en organización, muchos miembros se opusieron negándose a la iniciativa de incluir publicidades en los medios de Coderic y también se negaron a cumplir horarios, así como moderar el contenido de los mismos, lo cuál trajo como consecuencia la suspensión de los servicios por parte de los patrocinadores.
+Al intentar hacer cambios en Coderic para dejar de ser un grupo aficionado para convertirlo en organización, muchos miembros se opusieron negándose a la iniciativa de incluir publicidades en los medios de Coderic y también se negaron a cumplir horarios, así como moderar el contenido de los mismos, lo cual trajo como consecuencia la suspensión de los servicios por parte de los patrocinadores.
 
-El 30 de Septiembre de 2004 Coderic se constituyó formalmente como organización y comenzó a utilizar el nombre de forma oficial, en las redes y en los medios, vendiendo servicios de alojamiento web y desarrollo de sistemas, aún no constituido como compañia, luego de 6 meses acumulando fondos para el centro de capacitación y la fundación el 14 y 15 de Marzo de 2005 se lanzaron los portales.
+El 30 de septiembre de 2004 Coderic se constituyó formalmente como organización y comenzó a utilizar el nombre de forma oficial, en las redes y en los medios, vendiendo servicios de alojamiento web y desarrollo de sistemas, aún no constituido como compañía, luego de 6 meses acumulando fondos para el centro de capacitación y la fundación el 14 y 15 de marzo de 2005 se lanzaron los portales.
 
 == Clausura Temporal
 
-La documentación de Coderic se extravió el 3 de febrero de 2007 en un maletín durante un viaje. La pérdida de toda la información de los miembros de la organización, y la bitácora de aportes de los miembros, así como llaves de los servidores y mucha información sustancialmente valiosa, entre ellos, concluyó en el cese de actividades, acto seguido el 17 de Octubre de 2007 los servidores de Coderic sufrieron multiples ataques de seguridad.
+La documentación de Coderic se extravió el 3 de febrero de 2007 en un maletín durante un viaje. La pérdida de toda la información de los miembros de la organización, y la bitácora de aportes de los miembros, así como llaves de los servidores y mucha información sustancialmente valiosa, entre ellos, concluyó en el cese de actividades, acto seguido el 17 de octubre de 2007 los servidores de Coderic sufrieron múltiples ataques de seguridad.
 
 En respuesta a esto Daniel Acevedo diseño lo que se convertiría en la imagen de clausura de Coderic, un diseño que enunciaba los valores que representaban a la organización de la siguiente manera: «Los Valores son la estructura del éxito. Humanismo, Responsabilidad, Vocación, Compromiso, Integración y Fé».
 
@@ -46,4 +46,13 @@ https://locutoresyemisorasve.blogspot.com/p/emisoras.html[Locutores y Emisoras d
 
 == En la actualidad
 
-TODO
+Tras la reactivación en 2015, Coderic ha continuado evolucionando como organización tecnológica. Actualmente, la corporación se ha consolidado como una casa de software con un ecosistema tecnológico completo que incluye múltiples portales y servicios:
+
+* https://coderic.org/[Coderic.org] - Portal principal de la organización
+* https://coderic.co/[Coderic.co] - Portal de servicios empresariales
+* https://coderic.net/[Coderic.net] - Portal de servicios profesionales
+* https://coderic.cloud/[Coderic.cloud] - Portal de servicios en la nube
+
+La organización mantiene su compromiso con el software libre, la innovación tecnológica y el desarrollo de soluciones personalizadas para empresas y emprendedores. Coderic continúa siendo una comunidad de profesionales apasionados por la tecnología, enfocados en proporcionar herramientas e integración tecnológica al alcance de todos.
+
+Nuestro ecosistema tecnológico refleja nuestra visión de ser una organización socialmente sensible, orientada al servicio, y comprometida con la excelencia en el desarrollo de software y la transformación digital.