Don’t Use Scores From Automatic Tools in Your Accessibility Statement, by @cerovac_a11y:
Mark your calendar, grab a coffee 
— on April 30 (2–4pm CEST) you're invited to our #DocsReviewParty!
After a long road, the #Decidim documentation is finally updated to the latest version. Now we need you to help us review it!
Your feedback on structure, clarity, and content will help improve the docs for everyone — and it's a big step toward our goal of multilingual, community-driven #documentation by 2026.
Register: https://meta.decidim.org/assemblies/eix-comunitat/f/149/meetings/2087?locale=ca
Check the docs: https://docs.decidim.org/en/v0.29/index.html
What's wrong with AI-generated docs https://buff.ly/xAp81oX
let me tell you what’s wrong with docs and docs sets entirely generated by LLMs.
#discord IS LITERALLY THE PROBLEM!
It's worse than any #IRC, #Mumble or even the old #TeamSpeak & #Skype for that matter.
It combines the disadvantages of #Forum, #paywalled #documentation, #chat and #voicechat with 0 redeeming qualities (unlike #Zulip & Mumble & #XMPP+#OMEMO) it's just an #InformationBlackhole!
I'm shure fecking #dread has better moderation and I'd rather use #MicrosoftTeams + #Slack cuz those at least have proper #moderation tools.
Case in point: I'd rather #SelfHost all my comms infrastructure than to ever use something like Discord or any other #GDPR-violating SaaS that is just enshittification.
I'd rather recommend people to instead choose a tool that does everything but horrible to go with multiple smaller & good tools
Check @alternativeto and @european_alternatives for options.
#BlueSpice 5.0 is here! Reach a new level in managing your #company #knowledge. Discover new #features like the automated #DeepL #translation or the editor for #BPMN #process diagrams.
Test BlueSpice 5.0 now in our online #demo:
https://en.demo.bluespice.com/wiki/
Overview of all new features at:
https://bluespice.com/bluespice-5-0-has-arrived/
Over the past couple of months, I've been spending more time reviewing my tech notes from the last five years.
Partially out of a new interest in posting publicly & also trying to improve my writing.
Despite my placing numerous reference links & quotes in these notes, I feel that I'm really blurring the line between plagiarism, absorbing concepts & re-writing them in my own words.
These notes continue to be useful. Just can't quite place the source. A new imposter syndrome.
Everytime I have to write "Yeah, about this button. it doesn't do anything. Don't click it. The developers didn't finish that feature in time but were too lazy to hide it before we shipped" I die a little bit inside. #TechnicalWriting #documentation
Ujjwal Kala and Steve Piercy @stevepiercy discuss Triple D: Documentation-Driven Development #plone #plone6 #wpd2025 #CMS #Python #React #volto #opensource #community #documentation https://youtu.be/eu7ypPPKZCg
A lack of code documentation is killing new libraries.
Feeling my age.
Pawel Rucki used a John Travolta meme on a slide for looking for Shiny examples in documentation...and I was the only person to use the laugh emoji. 
Pas un, mais trois amendements déposés par des députés de la "Droite républicaine" (le groupe de Wauquiez) pour supprimer l'ABES (Agence bibliographique de l'enseignement supérieur) dans la" Simplification de la vie économique".
Ah, yes, the classic "blame the user" defense: Man pages are the epitome of pristine #documentation, and if you can't decipher them, it's obviously your profound incompetence. 
Clearly, the real issue is that you peasants insist on using those pesky programs that don’t reveal the hidden wisdom of man pages. 
https://whynothugo.nl/journal/2025/04/09/man-pages-are-great-man-readers-are-the-problem/ #blameTheUser #manPages #userExperience #techHumor #programming #HackerNews #ngated
Oyez, oyez ! personnels du #CNRS #ESR et #SHS, doctorants et post-doctorants, professionnels de la conservation du patrimoine... ! Les inscriptions à la #formation « Gestion de projet sur les sources numériques en SHS » sont ouvertes jusqu’au 23 mai 2025.
https://bvh.hypotheses.org/12624
#formation #formationcontinue #numérique #ingénierie #recherche #documentation #FAIR #scienceouverte #gestiondeProjet #dataESR #PGD ...
@gnuradio Here's the full list of #gnuradio block documentation pages that are mostly just missing an example flowgraph,
https://wiki.gnuradio.org/index.php?title=Category:Pages_with_no_Example_Flowgraph
and a list of block doc pages that are just stubs and would *love* to get some attention:
https://wiki.gnuradio.org/index.php?title=Category:Stub_Docs
You're not alone in this! If any questions/problems using the wiki or on GNU Radio #documentation in general arise, you can always find the docs on #Docs:gnuradio.org on matrix. Here's how you join the chat:
Addendum: I was wrong!
Original Post:
@dalias @servo already the #documentation seems to be #AI #hallucinated garbage.
And yes, undocumented, buggy and inefficient code will be the result, even if we don't think IP would be an issue...
@ptrc if one can't be assed to #code and #document themselves, why should I use their #software or trust their #documentation???
Documentation complaints.
The Curse of Knowledge is real in documentation; even big and pricey ecosystems skip basic information.
Two examples I ran into this morning:
1. GitHub's CODEOWNERS documentation does not explicitly mention where to create the file.
2. NPM's docs do not explain allowed characters in package names.
We have updated our Python Basics tutorial to describe the guidelines for docstrings in more detail:
https://python-basics-tutorial.readthedocs.io/en/latest/document/sphinx/docstrings.html#guidelines
#Python #Documentation #DX
new & final status update on 'moving image zines rdam':
The complete archive (355 videos) from 2005-2025 has been uploaded & is available on archive.org: https://archive.org/details/moving-image-zines-rdam?sort=-date
All videos are downloadable as high-quality files [mp4/h264 codec, 32 Mbit/s] and reusable under the Creative Commons Attribution-ShareAlike 4.0 International license.
Mike Amundsen 
