Like many open-source projects, the Uyuni Project has a long tradition of fostering community engagement and open dialogue, which is why those who are interested in configuration management should consider joining the Uyuni Community Hours scheduled for Feb. 24 at 15:00 UTC.

Uyuni Community Hours sessions take place on the last Friday of the month. The sessions offer an invaluable opportunity for both the community and the project’s development team to come together.

During these sessions, participants are presented with the latest developments surrounding Uyuni. This open forum allows the community to ask questions, provide feedback and suggest features or enhancements directly to the development team. This proactive approach helps Uyuni to evolve and align with the needs and expectations of its user base.

The session for this Friday addresses the community’s feedback and needs:

• Meeting Migration Recap: An overview of recent changes to the meeting platform, enhancing accessibility and participation for the community.

• What’s New in Uyuni: A detailed exploration of the latest features and improvements in the February 2024 release of Uyuni.

• Containerized Uyuni: Release Strategy: Insights into the future of Uyuni’s deployment and management within containerized environments.

• Uyuni Health Check: Running on top of a “supportconfig”: Introduction of a new tool designed to simplify and streamline health checks for Uyuni servers.

• One Shot Execution of Recurring Actions: A discussion on enhancing task management and execution within the Uyuni framework.

• Testing, Building, and Publishing the Documentation with GitHub Actions: An innovative approach to maintaining and distributing up-to-date documentation for Uyuni users and developers.

This session is accessible with a detailed agenda and is meant to keep the contributing community well-informed of upcoming topics and discussions. Whether a developer, administrator or an open-source software enthusiast, join the Uyuni Community Hours to offer valuable insights into the project’s progress and future initiatives.

Hay noticias que te llenan de una alegría que es difiícil de explicar. La Comunidad KDE y la compañía Slimbook siguen colaborando en aras de llevar a los sistemas libres al máximo número de gente posible. Hoy se presenta KDE Slimbook V, un renovado ultrabook 100% GNU/Linux, respaldado por la Comunidad KDE y con la garantía de la compañía valenciana, el cual nos ofrece más potencia, más posibilidades y un diseño más refinado. Además, ya que coinicide en tiempo con el MegaLanzamiento, nos encontramos con el primer ultrabook con Plasma 6 de serie. ¿Podríamos decir que estamos en un gran momento de KDE y Slimbook?

KDE Slimbook V, primer ultrabook con Plasma 6 de serie

Voy a repetir algo que comenté con el lanzamiento de KDE Slimbook 4 ya que aunque las aportaciones personales son muy importantes, al final son las Comunidades y las Empresas las que pueden hacer las cosas más grandes por el Software Libre. Y la desmostración de ello es la gama KDE Slimbook fruto de la Comunidad KDE y de la empresa valenciana de Slimbook.

Ambas entidades iniciaron en el 2017 una colaboración que se cristalizó con la línea KDE Slimbook, un ultrabook que acerca a una Comunidad de Software Libre un ensamblador de portátiles, consiguiendo no solo un producto refinado y optimizado sino que también una primera piedra sobre la que seguir mejorando los dispositivos libres. Y la demostración de esto es que una lanzamiento como este se ha repetido ya en cuatro ocasiones.

Sobre estas premisas los chicos de Slimbook y la Comunidad KDE han anunciado hoy 22 de febrero la disponibilidad de KDE Slimbook 5, el tercer portátil de la serie que ofrece procesadores AMD Ryzen, en esta ocasión, el 7840HS, que mejora la velocidad del ultrabook consumiendo menos energía. Además, esta CPU cuenta con una tarjeta gráfica integrada AMD Radeon 780M GPU, con 12 cores y RDNA 3, una tecnología especialmente diseñada para los videojuego, lo cual demuestra que estamos ante un ultrabook muy potente.

Ademá, será el primer ultrabook que va a llevar Plasma 6 de serie, lo que demuestra la alta confianza que tiene la Comunidad y Slimbook en el rendimiento del nuevo entorno de trabajo (y juegos) que presenta este dispositivo.

Todo ello montado sobre el clásico chasis KDE Slimbook con logo de KDE , tecla Meta serigrafiada con el símbolo de Plasma, con el estilo de letras Noto Sans, y que cuenta con dos jugosas novedades. La primera es que cuenta con una wwbcam con interruptor físico incorporado en el chais con lo que puedes apagar tu cámara de forma fácil y segura para proteger tu intimidad, se acabaron las pegatinas en el ocular de la cámara.

Novedades en este nuevo… Sssh🤫

Últimas pistas, mañana⏱️
Ready? https://t.co/BONhSQ7DKI#Cam #Bloqueo #SlimbookHype #NEW #Slimbook pic.twitter.com/zS141izQrQ

— SLIMBOOK (@slimbook) February 20, 2024

La segunda viene referida a la disipación de la calor del ultrabook ya que incorpora un doble ventilador para mejorar la capacidad térmica bajo cargas extremas, con lo que poner al máximo el ultrabook no será problemático.

Todo esto convierte este nuevo Slimbook V en el mejor ultrabook de la serie y supera al anterior KDE Slimbook 4 en todos los aspectos, como se demuestra en el siguiente gráfico que los compara.

Además, y una razón más para adquirir estos portátiles, con la adquisición de uno de ellos ayudas a la Comunidad KDE aportando una pequeña donación económica, que no repercute en el precio. En otras palabras, al comprar un KDE Slimbook parte del precio va destinado al Proyecto KDE.

Las características de KDE Slimbook IV

Es importante, además de toda la ética que rodea al proyecto, tener claro las características principales en términos de hardware de KDE Slimbook 5, que resumiendo son las siguientes:

• AMD 7840HS, CPU 8 núcleos 16 hilos hasta 5,1GHz y 24MB de caché
• GPU AMD 780M, integrada pero potente, con 12 núcleos y RDNA 3
• Webcam con interruptor físico
• Chasis completo de aluminio
• Pantalla de 16 pulgadas, relación de aspecto 16:10 y resolución 2560x1600px
• 2 PCIe 4.0
• 2 x DDR5 5600 MHz

Por otra parte, y dado que es fruto de la colaboración de una empresa de hardware con una Comunidad de Software, los aspectos destacados en cuento a aplicaciones o sistema operativo son los siguientes:

• Entorno de escritorio KDE Plasma 6
• Paquete ofimático LibreOffice
• Catálogo masivo de software gratuito instalable a través de la aplicación Discover integrada

¿Por qué KDE Slimbook?

Son muchas las razones por las que vale la pena apostar por un KDE Slimbook aparte de tener un magnífico Slimbook con un serigrafiado que unifica el logo de KDE con el de Slimbook. En esta lista incluyo algunas de las más importantes:

• Porque la Comunidad KDE se ha asegurado que KDE/Plasma funcione perfecto en el portátil creando un OEM para él.
• Porque es la forma más segura de de utilizar KDE.
• Porque ayudas a la Comunidad KDE aportando una pequeña donación económica, que no repercute en el precio. Edito: En otras palabras, al comprar un KDE Slimbook parte del precio va destinado al Proyecto KDE.
• Porque es una instalación limpia de KDE, sin aplicaciones extra que te puedan distraer
• Porque con Discover tienes al alcance cientos de aplicaciones instalables con un simple click.
• Porque el portátil se actualizará al ritmo de KDE Neon, lo cual significa estar siempre a la última.
• Porque existen muchas vías para solucionar de forma directa (SAT de Slimbook, foros de Slimbook, grupo de Telegram de KDE Neon, foro de KDE, etc) los posibles problemas o dudas que aparezcan en el uso diario del portátil.

Y por cierto, no penséis que hago toda esta publicidad porque reciba una compensación económica… la publicidad del margen es voluntaria y no recibo nada por ponerla.

Más información: KDE Slimbook | Slimbook

La entrada KDE Slimbook V, primer ultrabook con Plasma 6 de serie se publicó primero en KDE Blog.

Hoy mismo ha sido lanzado GCompris 4.0 , una nueva versión que viene con 8 nuevas actividades con lo que ya son 190 los juegos educativos disponibles. Otro paso de una aplicación que sigue ofreciendo verdaderas maravillas para niñas y niños y que no deja de evolucionar y mejorar.

Lanzado GCompris 4.0, con 8 nuevas actividades educativas

Como nos tiene acostumbrado el equipo de desarrolladores de GCompris, cada nuevo lanzamiento de esta suite de juegos educativos nos ofrece una buena colección de novedades

Este GCompris 4.0 no es una excepción y a las típicas correcciones de errores y actualizaciones en el paquete de idiomas que forman parte de la suite, esta versión nos ofrece algunas interesantes mejoras entre las que destacan sus 8 nuevas actividades:

• «Clases de gramática» es una actividad para identificar palabra de clases gramaticales, una clase a la vez.
• «Análisis gramatical» es similar a la actividad anterior, pero con varias clases solicitadas para cada frase.
• «Calcudoku» es un juego de aritmética donde el objetivo es rellenar una cuadrícula con números siguiendo ciertas reglas.
• En «Adivina 24», usa los 4 números que se dan y los operadores para encontrar el número 24.
• En «Friso», reproduce y completa los diferentes frisos.
• «Lee una línea graduada» es una actividad donde debes encontrar un valor que se representa en una línea graduada.
• En «Usa una línea graduada», coloca el valor que se indica en la línea graduada.
• En «Números adyacentes», aprende los números que preceden o siguen a una secuencia determinada.

Y, además, esta versión añade traducciones para tres idiomas más: búlgaro, gallego y suajili.

Puedes encontrar paquetes de esta nueva versión para GNU/Linux, Windows, Raspberry Pi y MacOS en la página de descargas. Esta actualización estará disponible en breve en la Play Store de Android, el repositorio F-Droid y en la Windows Store.

Quisiera destacar que en mi opinión esta aplicación debería estar presente en todas las comunidades educativas, como lo está en muchos centros logopédicos.

Más información: GCompris

¿Qué es GCompris?

GCompris es un colección de aplicaciones educativas que contiene diferentes actividades para niños entre 2 y 10 años de edad. Originalmente GCompris estaba escrito lenguaje C y Python utilizando las herramientas de GTK+ pero a principios de 2014, desde que sus desarrolladores anunciaron que pasaban a ser un proyecto de la Comunidad KDE, se ha reescrito en a C++ y QML utilizando las herramientas Qt.

Más información: GCompris

La entrada Lanzado GCompris 4.0, con 8 nuevas actividades educativas (otra vez) se publicó primero en KDE Blog.

Creo que es la primera vez que publico una entrada de este tipo y que merece toda nuestra atención: la FreeCAD Project Asociation anuncia subvenciones para desarrolladores que impulsen FreeCAD, uno de los mejores programas de diseño CAD de código abierto. ¿Quieres saber más? Sigue leyendo.

FreeCAD Project Asociation anuncia subvenciones para desarrolladores

Para quienes no lo conozcan, Freecad es un programa de diseño gráfico en 3D libre pensado principalmente para el diseño mecánico pero que también sirve para todos los demás usos en los que se necesita modelar objetos 3D con precisión y control sobre el historial de modelado.

FreeCAD ha estado en desarrollo desde 2002, y ofrece una gran lista de características. Aún le faltan capacidades, pero es lo suficientemente potente para uso de aficionados y pequeños talleres.

En el blog ha aparecido en varias ocasiones, como por ejemplo, promocionar los video-tutoriales de Juan Gonzalez Gomez (conocido en la red y en el mundo maker como Obi Juan) o cuando Linux Center organizó un taller de diseño e impresión en 3D en 2022.

Dado que le faltan características la Asociación del Proyecto FreeCAD (FPA), una asociación internacional sin ánimo de lucro creada por administradores y desarrolladores del núcleo de FreeCAD en noviembre de 2021, ha pensado que lo mejor es invertir parte del dinero que manejan en subvencionar el trabajo de sus colaboradores. Algo que me parece sumamente interesante.

Para que quede todo claro lo mejor es leer íntegro el anuncios de la FreeCAD Project Asociation ya que de esta forma no hay dudas de esta nueva iniciativa.

La Asociación del Proyecto FreeCAD se complace en anunciar la creación del Fondo de Desarrollo de la FPA (FPADF). El FPADF ofrece subvenciones a individuos para contribuciones a FreeCAD.

Las subvenciones tienen un límite de 5000 dólares y se concederán sólo para trabajar en el código base de FreeCAD.

El límite podrá aumentarse a medida que la FPA adquiera experiencia en la concesión de subvenciones y los fondos disponibles lo permitan.

Cualquier colaborador que desee ser considerado para una subvención debe presentar una propuesta por escrito a la FPA. La propuesta debe indicar claramente cuánto dinero se solicita y qué pretende crear/mejorar/arreglar el contribuyente. Deberá incluirse un calendario estimado con los principales hitos, junto con criterios claros de finalización.

Las propuestas serán consideradas por el órgano general de la FPA y aprobadas por votación.

A la Asociación de Proyectos FreeCAD le gustaría ampliar el número y tipo de subvenciones concedidas. Las donaciones realizadas a la FPA y designadas FONDO DE DESARROLLO se utilizarán para este propósito.

Las solicitudes de subvención pueden ser enviadas a cualquier miembro de la FPA para su consideración.

En resumen, una iniciativa más que interesante ya que es una forma de potenciar el desarrollo del software libre pocas veces vista pero que estoy seguro que será muy positiva.

Más información: FreeCAD Project Asociation

La entrada FreeCAD Project Asociation anuncia subvenciones para desarrolladores se publicó primero en KDE Blog.

The following article has been contributed by Ancor González Sosa and the YaST team at SUSE.       At the end of 2023, we announced Agama 7, a new service-based installer for Linux. That version was the first prototype we could consider to be ‘functional enough’ for our purposes, as it covers areas such […]

The post The Year of Agama – an outlook to the 2024 roadmap appeared first on SUSE Communities.

Con la publicación de la versión 7 de Agama a finales de 2023, se llegó a una versión lo suficientemente funcional, que en este 2024 se seguirá puliendo y dando forma

Por el blog ya he escrito algunos artículos sobre Agama, pero hagamos un recordatorio rápido sobre qué es Agama.

Agama es un nuevo instalador de Linux nacido en el seno del equipo de YaST. Está diseñado para ofrecer reutilización, integración con herramientas de terceros y la posibilidad de construir interfaces de usuario avanzadas sobre él.

Nace de YaST, el atual instalador de openSUSE, al que se le quiere adaptar, y eliminar barreras de un código que ya tiene bastantes años.

El equipo de desarrollo de Agama, quiere que en este 2024, haya un cambio significativo y sustancial en su software. Para ello se ha marcado un par de hitos en el año, para tener unos objetivos hacia los que encaminar sus esfuerzos.

Las fechas clave corresponden una a mediados de abril y otra a mediados de julio de este año 2024. Cada cita centrada en unos objetivos distintos.

El primer hito corresponde a cambios en la arquitectura propia del código. Desde el inicio del proyecto se han apoyado en Cockpit, pero llegados a este punto de desarrollo de Agama, esa dependencia es muy limitante.

Por lo que se explorarán nuevas alternativas que hagan que Agama pueda crecer en funcionalidades.

El segundo hito se refiere a la propia interfaz y las opciones de almacenamiento durante el proceso de instalación.

Detrás de estos cambios de la nueva herramienta, habrá mucha discusión y horas de implementación de código, pero no solo eso, también a la hora de recolectar ideas sobre la mejor manera de realizar tal o cual tarea.

Y el proyecto openSUSE y SUSE, tienen como marca de la casa el que todo el código es libre y abierto, por lo que podemos participar en el nuevo desarrollo de Agama, con contribuciones u opiniones.

Ya sea en listas de correo, canales IRC o en la plataforma GitHub que es donde se desarrolla el código, tu opinión cuenta y tus aportes pueden hacerse realidad.

Agama se basa en trabajo realizado en YaST, pero al que se le quiere daruna segunda vida, adaptándolo a un presente que ha cambiado mucho y en el que tienes voz y voto y donde puedes aprender y compartir tus conocimientos.

Enlaces de interés

• https://yast.opensuse.org/blog/2024-02-08/year-of-agama
• https://github.com/openSUSE/agama

Can you run SUSE on a $65 Laptop?

Yeah, but you might not want to.

Of all of the computers that I have owned over the years, the two that remember the most fondly are netbooks. I was one of the first to get an eeePC. I put Ubuntu on it, and a friend at work was able to do some firmware cutting to get all of the hardware enabled. I moved on to the next eeePC version, and then on to one of the most useful computers I ever had, a Dell Mini 10v. I actually bought one for myself, and one for each of my kids. If I remember correctly, I was able to buy them through the Dell partner portal or something. I had a black one, but one of my kids got red, and one got blue. The “10” stood for the 10 inch screen, and the “v” meant that it was a “value” model, which, for me, meant that the graphics were supported with open source intel drivers instead of binary nvidia goo.

The beauty of these computers was that they were small and reasonably light, so I could lug them around to conferences and work trips quite easily. I am sad that I don’t really see anyone making netbooks anymore, but when I saw that you could get an $80 eleven inch computer at Microcenter, and that some folks had some luck installing Linux on it, I decided to go for it. You see, I have some work trips coming up, and I thought it would be nice to have a compact and cheap computer with me for these trips, rather than my expensive high performance laptop that I use as my daily at work.

I’ve always been an early adopter of tech when it reaches new levels of access. For example, my 3D printer was one of the first low drama, low cost printers (thanks Monoprice). I also bought the first sub $500 laptop,which had about 40 minutes of battery life.

“Wait”, you say? The title says $65, but you said it was $80? That’s right, Evolve III Maestro is on sale for $80 at Microcenter. When I went to look at it, I didn’t see it out on display, so I asked about it. It turns out that they don’t have it out, you have to know to ask, and you can’t see it, you have to buy it “sight unseen.” Yikes. The technician helping me said he could check if there was an open box in the back, and if so, he could let me have a look before I bought it. He brought it out, and sure enough, it was a small, cheap computer. I asked if there was a discount for buying the open box, and sure enough, $15 off. So there you go, I got a computer for $65.

The device is … erm … bare bones. For example, no USB-C ports. The keyboard is not exactly an IBM Selectric feel. I have a 5 year old 11 inch MacBook Air that I bought for like $2,000, and let’s just say, the build quality of Evolve III is “not quite at the same level.”

So, how did it go getting Leap on there? Getting into the bios and adjusting the boot menu to boot from my USB install media was pretty easy, after I did some web searches to find that “delete” is the magic key to get into the bios. Unfortunately, the wifi driver for the wifi module is too new, and so the built-in wifi is not supported in Leap 15.5s kernel, and of course there is no Ethernet port. After some confusing loops in the installer trying to get it to install without a network connection, I pulled out a random USB hub with an ethernet adapter that I had in my closet, and then used a USB-C to USB 3 connector. This actually worked.

Given the small screen and the low specs, I opted for xfce for the desktop rather than my normal GNOME choice. Having an easy choice of “roles” at install is sweet.

The install wasn’t exactly fast, but it installed just fine. It occurred to me that instead of struggling with the unsupported built in wifi, I had some wifi dongles lying around, I could use one of those. The first one I tried was RALINK something something, and I looked it up, and there was a kernel module for it, but no package for it. I figured if I was going to go through that much pain, I would rather focus on getting the internal wifi module to work.

After some epic scrounging through a box of rpis, sensors, motors, and other crap, I found an official rpi dongle, that turned out to be an already supported Broadcom wifi modem, so now I have wifi. The dongle doesn’t see my “5g” network, but it works. I figure that making the real wifi work (and documenting it) will be an irresistible challenge for one of the Linux engineers I am surely going to meet up with in the next few months.

So that’s it, it’s mostly running. I installed Cheese to test the webcam, it works just fine.

On the audio side, Pulse doesn’t detect built in speakers or the built in microphone, but it works just fine with my Plantronics headset that SUSE sent me. I can’t really be bothered to make the built in audio work, because I assume that the hardware is going to produce terrible results anyway. There is an 1/8 inch pin connector as well, but I haven’t tried that or bluetooth yet. The bluetooth dialog works so I trust that bluetooth works generally. I barely use bluetooth with laptops, so I leave it off.

Lastly, the computer came with mini HMDI, and I don’t seem to have an adapter for that around, so I will need to pick one up. Because the computer came with Intel graphics, I am confident that it will “just work”, but you never know.

Fortunately, I wrote a blog post about getting my real power house work machine set up, so I was able to follow those steps to get chrome, vscode,and slack installed and running. Xfce-wise I read up on how to do some light configuration, especially getting the apps that I use most on the panel.

All told, I'm thinking this machine might suit for travel. The keyboard is a little awkward, so I miss a lot of characters when I type. When typing in resource hungry web pages, like google docs or slack, it is very laggy. It really makes me miss the days of real netbooks. It’s great that it’s so cheap, but what I wanted was small. I would have rather have a smaller machine with a better build.

Όσοι με γνωρίζουν, επιμένω συνέχεια στους προγραμματιστές να γράψουν σχόλια στον κώδικά τους αλλά και να γράφουν τεκμηρίωση γενικότερα.
Πιστεύω ότι υπάρχουν δύο κύριοι λόγοι που οι προγραμματιστές δεν γράφουν τεκμηρίωση. Τα εργαλεία παίζουν το ρόλο τους, αλλά είναι άλλοι λόγοι.

Το γράψιμο είναι δύσκολο

Οι "μηχανικοί λογισμικού" δεν γράφουν γιατί η σαφής γραφή είναι πολύ, ΠΟΛΥ δύσκολη.

Η συγγραφή είναι ένα δύσκολο, απαιτητικό έργο. Απαιτεί να οργανώνουμε με σαφήνεια τις σκέψεις μας, να τις εξετάζουμε κριτικά και να τις εκφράζουμε καθαρά. Το εκφραστικό μέρος μπορεί να απλοποιηθεί σε κάποιο βαθμό (ανάλογα με την ποιότητα γραφής που απαιτείται).

Στον κόσμο του προγραμματισμού, όπου το "εξαρτάται" είναι συχνά η καλύτερη απάντηση και όλα βασίζονται σε συμβιβασμούς, το γράψιμο γίνεται πολύ πιο δύσκολο. Πρέπει να καθοριστεί το πλαίσιο, να αιτιολογηθούν οι αποφάσεις και στη συνέχεια, να ενισχυθεί τη σκέψη χαμηλού επιπέδου που οδηγεί στον κώδικα. Αυτός ο τύπος γραφής είναι χρήσιμος μόνο εάν γίνεται καλά, και επειδή το γίνει καλά είναι δύσκολο, συχνά δεν γίνεται καθόλου. Ο κακός κώδικας θα συνεχίσει να δουλεύει, η κακή τεκμηρίωση μπερδεύει.

Αυτός είναι ο λόγος για τον οποίο πολλοί άνθρωποι διαφωνούν σχετικά με την αξία των σχολίων στον κώδικα και τα πλεονεκτήματα της αυτο-τεκμηρίωσης κώδικα (ό,τι κι αν σημαίνει αυτό). Ο Kevlin Henney λέει ότι "το να ζητάμε σχόλια γύρω από περίπλοκο κώδικα είναι μάταιο, επειδή περιμένουμε από τους ίδιους ανθρώπους που δεν μπορούσαν να εκφραστούν καθαρά στον κώδικα να εκφραστούν καθαρά και κατανοητά με κείμενο (Αγγλικά)".

Η μη τεκμηρίωση δεν εμποδίζει την κυκλοφορία

Εάν ένας προγραμματιστής δεν γράψει τεκμηρίωση, η δουλειά του εξακολουθεί να έχει ολοκληρωθεί. Το να μην γράψει τεκμηρίωση δεν εμποδίζει την κυκλοφορία του προγράμματος (τουλάχιστον όχι αμέσως). Η ζημιά που προκαλείται από τη μη τεκμηρίωση τεχνικών αποφάσεων είναι σωρευτική. Όπως το τεχνικό χρέος, δεν προκαλεί ζημιά εδώ και τώρα.

Όπως ειπώθηκε και παραπάνω, η συγγραφή είναι πρωτίστως θέμα σκέψης και ανάλυσης. Στα περισσότερα μέρη, η συγγραφή κώδικα μπορεί να γίνει εύκολα. Ένας αποδιοργανωμένος σωρός κλάσεων και μεθόδων στον κώδικα μπορεί να λειτουργήσει - ένας σωρός λέξεων και παραγράφων δεν θα λειτουργήσει. Η γραφή ΠΡΕΠΕΙ να είναι σαφής εάν πρόκειται να είναι χρήσιμη. Ο κώδικας θα γίνει αποδεκτός (σε κάποιο βαθμό) αρκεί να κάνει τη δουλειά του. Και δεδομένου ότι οι περισσότεροι οργανισμοί επικεντρώνονται μόνο στην κυκλοφορία του προϊόντος, αυτό που δεν εμποδίζει την κυκλοφορία αγνοείται.

Οι δοκιμές (unit tests) αντιμετωπίζουν παρόμοιο πρόβλημα σε πολλές ομάδες. Για να ελέγξουμε τον κώδικα πρέπει να τον κατανοήσουμε (που απαιτεί περισσότερη προσπάθεια από τη σύνταξη του) και η απουσία δοκιμών δεν εμποδίζει την κυκλοφορία. Επομένως, συνήθως δεν υπάρχουν δοκιμές σε κώδικα.

Υπάρχει και το θέμα της παλαιότητας. Ακόμη και τα καλά έγγραφα είναι παρωχημένα, επομένως οι προγραμματιστές πρέπει να συνεχίζουν να επαναλαμβάνουν το σκέφτομαι-αναλύω-εκφράζω ξανά και ξανά καθώς κατασκευάζουν συστήματα. Έτσι, η αποφυγή της συγγραφής της τεκμηρίωσης είναι εύκολη. Έτσι, ακόμη και με τις καλύτερες προθέσεις, η τεκμηρίωση συμβαίνει συχνά μόνο σε στιγμές συγγραφής και καθαρισμού.

Τι γίνεται με τα εργαλεία

Δεν υπάρχει αμφιβολία ότι το σύνολο εργαλείων που χρησιμοποιούνται συνήθως για την τεκμηρίωση λογισμικού σήμερα είναι θλιβερά ανεπαρκή. Δεν σκεφτόμαστε τα έγγραφα ένα-ένα. Σκεφτόμαστε με όρους ιδεών και στόχων συγκεντρώνοντας πολλές έννοιες ταυτόχρονα. Το έγγραφο που προκύπτει είναι μόνο μια εκδήλωση της διαδικασίας σκέψης. Χρειαζόμαστε εργαλεία που μπορούν να μας βοηθήσουν να συγκεντρώνουμε ιδέες διαχρονικά για να λύσουμε το πρόβλημα. Τα Έγγραφα Google, το Confluence, το Markdown είναι όλα κακά εργαλεία για αυτόν τον τύπο γραφής.

Ωστόσο, μια νέα γενιά εργαλείων όπως το Notion και το Roam αντιμετωπίζουν αυτό το πρόβλημα της αξιοποίησης των εργαλείων. Ας ελπίσουμε ότι αυτά θα λειτουργήσουν όπως προβλέπεται και θα βοηθήσουν στη σκέψη που οδηγεί στη συγγραφή.

Ωστόσο, η έλλειψη δεύτερου εγκεφάλου δεν μπορεί πραγματικά να χρησιμοποιηθεί ως δικαιολογία για τη μη χρήση του πρώτου. Τα εργαλεία παίζουν το ρόλο τους, αλλά η προθυμία να αναλάβει τη διαδικασία είναι το πραγματικό εμπόδιο.

Πώς να δημιουργείτε λοιπόν τεκμηρίωση

Το λογισμικό γραφής μας δίδαξε ένα πράγμα. Αν θέλετε πραγματικά οι χρήστες σας να κάνουν κάτι, τότε αυτό θα πρέπει να είναι ένα βήμα που τους εμποδίζει στο ταξίδι τους με το προϊόν σας. Με τον ίδιο τρόπο, η προσαρμογή τεκμηρίωσης σε γραπτό κώδικα δεν πρόκειται ποτέ να λειτουργήσει. Ακόμα χειρότερα, είναι άχρηστη. Η συγγραφή έχει να κάνει με την κριτική σκέψη. Σκοπός της είναι να εξηγήσετε τη διαδικασία σκέψης και την πρόθεσή σας στον εαυτό σας και στο ακροατήριό σας (π.χ. την ομάδα σας). Η διαδικασία σκέψης είναι το σημείο όπου η τεκμηρίωση/συγγραφή προσθέτει αξία, όχι ως στατική καταγραφή ήδη υλοποιημένου κώδικα.

Οι υποστηρικτές του προγραμματισμού mob/pair και των XP συχνά υποτιμούν την τεκμηρίωση. Αλλά αν δεν υιοθετηθούν αυτές οι τεχνικές, η πρακτική της συγγραφής και της αναθεώρησης των τεχνικών εγγράφων είναι ο μόνος τρόπος με τον οποίο οι ομάδες οικοδομούν μια συλλογική κατανόηση αυτού που προσπαθούν να οικοδομήσουν. Αυτή η κοινή οικοδόμηση του κόσμου είναι που καθιστά αυτή τη διαδικασία κρίσιμη για τη μακροπρόθεσμη υγεία της ομάδας και της βάσης κώδικα.

Ο μόνος τρόπος για να καταστεί βιώσιμη η διαδικασία συγγραφής τεκμηρίωσης είναι να την καταστήσουμε ανασταλτικό παράγοντα για την ανάπτυξη λογισμικού. Να την κάνουμε ελαφριά αλλά υποχρεωτική. Θα πρέπει να γίνει μέρος της διαδικασίας αντί να είναι ένα ακόμη πράγμα που πρέπει να κάνουμε. Μερικά πράγματα που έχουν λειτουργήσει για αυτό από την εμπειρία μου.

• Γράψτε τεκμηρίωση πριν τον κώδικα. Εκτός αν η αλλαγή είναι ασήμαντη, κάθε προγραμματιστής γράφει ένα σημείωμα για το τι πρόκειται να κάνει και το περνάει από την υπόλοιπη ομάδα. Στο τέλος της συζήτησης, η πραγματική συγγραφή κώδικα θα πρέπει να γίνει ασήμαντη.
• Γράψτε απλά. Μην περιπλέκετε το κείμενο, τουλάχιστον μέχρι να γίνει συνήθεια. Τα διαγράμματα, οι φανταχτερές ενότητες κ.λπ. μπορούν να περιμένουν. Γράψτε πολύ απλά για το τι σκεφτήκατε, τι κάνετε και γιατί. Ακόμη και αν το έγγραφο μπορεί να χρησιμεύσει ως βασικός δείκτης για την υπόλοιπη ομάδα τώρα και στο μέλλον, είναι εξαιρετικά πολύτιμο.
• Τεκμηριώστε την απόφαση με τις εναλλακτικές τους - Αντί να τεκμηριώνετε λεπτομερώς την πραγματική υλοποίηση (η οποία μπορεί να αλλάξει με την πάροδο του χρόνου), επικεντρωθείτε στην τεκμηρίωση των επιλογών και του λόγου για τον οποίο έγιναν. Αυτό είναι κάτι που ο κώδικας δεν μπορεί ποτέ να εξηγήσει και ως εκ τούτου η καταγραφή του τον κάνει πολυτιμότερο. Οι λεπτομέρειες μπορούν να τεκμηριωθούν με βάση τον χρόνο που είστε διατεθειμένοι να επενδύσετε.
• Κάντε την αναζητήσιμη - Καμία ποσότητα τεκμηρίωσης δεν θα έχει καμία χρησιμότητα εάν οι χρήστες δεν μπορούν να την βρουν. Χρησιμοποιήστε εργαλεία που υποστηρίζουν την αναζήτηση κειμένου. Αυτός είναι ένας από τους λόγους για τους οποίους δεν μου αρέσουν τα Έγγραφα Google για τεκμηρίωση. Είναι εξαιρετικό για τη συγγραφή, αλλά απλά απαίσιο για τη συνεργασία και την ανακάλυψη της πληροφορίας.
• Παρακολουθήστε τις αλλαγές. Ορισμένοι οργανισμοί χρησιμοποιούν τον έλεγχο εκδόσεων (version control όπως πχ github) για να παρακολουθούν τις αλλαγές στο σχεδιασμό του συστήματος με την πάροδο του χρόνου. Αυτό είναι υπέροχο. Αλλά αν δεν έχετε φτάσει ακόμα εκεί, κρατήστε ένα έγγραφο ανά χαρακτηριστικό και συνεχίστε να βάζετε σε αυτό ενημερώσεις με ημερομηνία, ώστε η εξέλιξη να μπορεί να παρακολουθείται σε ένα μέρος με ελάχιστη ταλαιπωρία.

Η ελπίδα είναι ότι καθώς η ομάδα φαίνεται να αντιλαμβάνεται τα πλεονεκτήματα της ύπαρξης και της αναθεώρησης ορισμένων εγγράφων (π.χ. τα νέα μέλη χρειάζονται λιγότερη βοήθεια) και η συγγραφή γίνεται συνήθεια, η πρακτική θα γίνει αυτοσυντηρούμενη. Μέχρι τότε, θα πρέπει να αντιμετωπίζεται όπως η γυμναστική ή η δίαιτα - επώδυνη αλλά απαραίτητη.

Me complace presentar» Escape to Freedom», un vídeo de la Free Software Foundation que publicó en el 2022 y que intenta hacernos reflexionar sobre la necesidad de tener un control sobre nuestra vida digital para tener nuestros derechos fundamentales protegidos.

Escape to Freedom, vídeo de la Free Software Foundation

El mundo del Software Libre es mucho más grande de lo que pensamos, y es que para los humanos el número de humanos que hay en el mundo es un concepto que no podemos procesar bien. Solo tenéis que ir un día a una estación de tren o a un aeropuerto para comprobar la cantidad de trenes/aviones que circulan, pensar que la mayoría van llenos y después reflexionar que cada una de las personas que veis tiene una vida similar a la vuestra, con sus familiares, amigos y conocidos para poder vislumbrar cuánta gente somos.

Esta reflexión da pie a entender que en esto del Software Libre, a pesar de que cuando se hace algún evento parece que somos cuatro gatos, en realidad detrás hay centenares de personas que sí están interesadas y que participan activamente en su desarrollo.

Esto explica cosas como la gran cantidad de proyectos de Software Libre que hay en el mundo, un número creciente a pesar de las dificultades tecnológicas y, por qué no decirlo, políticas que en vez de remar a favor de la protección de los derechos de los individuos buscan como sacar provecho económico de cualquier circunstancia.

Todo lo anterior era un poco para justificarme por no presentar este vídeo antes ya que cualquier cosa que sea por promocionar el Software Libre a niveles bajos es fundamental si alguna vez queremos que nuestra sociedad se vuelva mucho más seria y responsable.

Pero bueno, me voy del tema. Hoy quería compartir con vosotros un vídeo que ya tiene dos años y que lleva por título «Escape To Freedom». Una creación de la Free Software Foundation (FSF) y que pretende ser una introducción a los conceptos que subyacen a la libertad del software: qué ganamos con ella y qué derechos están en juego.

En palabras de la FSF:

Este vídeo es la última incorporación a la serie de vídeos animados creados por la FSF sobre el tema del software libre. Pensamos en Escape to Freedom como una fábula que demuestra las consecuencias demasiado reales de no tener control sobre tu propia informática, y lo importante que es nuestra lucha colectiva por la liberación digital.

Al trabajar esta vez con un estilo de animación surrealista, esperamos haber ilustrado de forma evocadora algunos de los efectos emocionales que el software no libre y la falta de control sobre la propia autonomía digital pueden tener en la vida cotidiana.

Escape to Freedom muestra a los enemigos monopolistas del movimiento con una lente inquietante, pero esperamos que esta distorsión de la realidad ayude a mostrarlos tal y como son en realidad. Escape to Freedom presenta el movimiento siguiendo la tradición de la alegoría, y describe la necesidad de la libertad del software de forma que capte la atención de los usuarios de ordenadores sin conocimientos técnicos.

Help others find free software: Watch and share Escape to Freedom by Greg Farough

Bien, no os mareo más y os dejo el vídeo, el cual creo que es un buen material para poder concienciar a aquellas personas que todavía no son conscientes de la importancia del Software Libre en sus vidas.

¿Que es la FSF?

Por no hacer más larga la entrada, la La Free Software Foundation (FSF) es una entidad sin ánimo de lucro con la misión de promover mundialmente la libertad de los usuarios de computadores y defender los derechos de todos los usuarios de software libre.

Tiene una intensa actividad y os aconsejo visitar su página web para poder sacar provecho de todo lo que ofrece: información, materiales, contactos, etc.

Más información: FSF

La entrada Escape to Freedom, vídeo de la Free Software Foundation se publicó primero en KDE Blog.

A quick update on the Request Page Redesign: the build summary chart bars are now clickable. A simple click on the bar will open an overview of the builds, which will be displayed under the Build Results tab on the request page and will have the corresponding filters applied. You can see a build summary chart on the request page only when the submitted packages build against a long list of repositories. Clickable build summary...