"Among the many forms of yak shaving that plague our craft is obsessing over documentation tooling. The more technically minded among us are guilty of spending too much time tightening the screws of some CI pipeline just to save a few seconds when building the docs. As exercises, they’re indeed useful, for they help us practice technical skills that might lead us to becoming docs engineers. Should we park writing the docs over picking static-site generators though?
The danger lies in mistaking the motion for progress. A perfectly tuned pipeline that builds no new useful content is a monument to wasted effort. It’s the equivalent of a chef who spends all day sharpening their knives to a razor’s edge but never actually cooks a meal. The knives are essential, but they are not the dinner. Our tools are essential, but they are not the documentation. The user who is stuck at 2 AM with a failing API call does not care about your elegant build process; they care about finding the answer."
For anyone who wonders about the absence of system requirements for FreeBSD:
― the two bug reports linked from https://www.reddit.com/r/freebsd/comments/1lcm1ze/freebsd_system_requirements/ may be of interest.
I reopened the first report following premature rejection.
Rejection of the second report is a concern, but not my concern. In the absence of documentation, everyone loses.
Un #garde #forestier protège et gère les forêts, préserve la biodiversité, lutte contre les activités illégales et sensibilise le public. A lire ici --> https://wp.me/pbyKZP-1bgA #bûcheron #docs #documentaires #arbres #arbre #brutnature #brut #doc #Buzz #docu #documentaire
Docs, l’éditeur de texte libre et collaboratif de La Suite numérique, a été reconnu "bien public numérique" (Digital Public Good) par la Digital Public Goods Alliance ce matin à l’ONU lors de la semaine Open Source des Nations Unies.
https://www.digitalpublicgoods.net/r/docs-collaborative-text-editing
Ce label marque une étape importante pour ce logiciel issue du partenariat franco-allemand-néerlandais
#LogicielsLibres #OpenSource #DigitalPublicGoods #ONU #Europe #Docs #SouverainetéNumérique
Como Criar um Currículo Profissional Grátis no WPS Office Writer/Docs (Passo a Passo): https://youtu.be/lo0wazqM5ZM
The Microsoft Docs MCP Server has shipped and provides AI assistants with real-time access to official Microsoft documentation.
Check it out on GitHub here: https://github.com/MicrosoftDocs/mcp