Happy to contribute to #Cilium (#documentation).
Good tools deserve good docs. ✨
https://github.com/cilium/cilium/pull/44204
Let's see where this goes!
#Documentation
shelldoc is back! Announcing 0.90: https://github.com/mirkoboehm/shelldoc
shelldoc tests shell commands in your Markdown docs to keep examples accurate.
It's ready for use today. 0.90 is the first of three release candidates before 1.0.
New:
- Bug fixes & security improvements
- Go 1.21 + updated deps
- GitHub Actions CI for selftests
- Better docs
Testing encouraged, contributions welcome!
`go install github.com/mirkoboehm/shelldoc/cmd/shelldoc@v0.90`
@mwl agreed: documentation.
#40 - FreeBSD 'system requirements' are not documented at the Project site or the documentation portal - grahamperrin/freebsd-doc - Codeberg.org — <https://codeberg.org/grahamperrin/freebsd-doc/issues/40> (2023). There's a reminder that in the past, the FreeBSD Handbook did include minimum hardware requirements.
In 2025 I took the issue to Bugzilla for FreeBSD. Less than an hour later, it was rejected: <https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=287722>.
#FreeBSD #documentation #RAM #memory #requirements #UFS #ZFS
I'm streaming KDE docs:
- right now! 7 PM UTC
- on https://twitch.tv/herzenschein
Be sure to join and ask any questions related to KDE and I'll try my best to answer them.
Every single stream I do is an Ask Me Anything KDE Edition ™️
Today I'll see about improving KConfig (which @me was curious about :P) and maybe play a bit of beginner Super Mario World kaizo romhacks in the end.
#KDE #Linux #Documentation #TechnicalWriting #FurryStreamer #FurryVTuber #VTuber #Twitch
Source: https://www.arthurperret.fr/veille/2026-02-04-pandoc-dans-le-navigateur.html (Pandoc dans le navigateur)
- https://github.com/jgm/pandoc/releases/tag/3.9 (2026-02-04, Starting with this release, pandoc can be compiled to WASM, making it
possible to use pandoc in the browser. A full-featured GUI interface is provided at https://pandoc.org/app)
Pandoc est désormais utilisable via une application web officielle.
Attention, cliquer sur le lien ci-dessus implique de charger 50 Mo de données : normal, puisque la page contient tout Pandoc !
On parle ici d’un fantastique convertisseur de fichiers, que j’utilise personnellement pour rédiger confortablement tout mon travail dans un format texte adapté à mes besoins d’écriture scientifique et ensuite exporter mes fichiers dans différents formats (HTML, PDF via LaTeX, ODT, docx, EPUB…).
Pandoc s’utilise normalement en ligne de commande, un environnement qui fait parfois peur aux néophytes (ce qui m’avait motivé à écrire un tutoriel sur la découverte du terminal).
Ici, on a une interface web, réalisée grâce au format WebAssembly, donc zéro installation requise, mais aussi des exemples pré-chargés, et la garantie que rien ne s’échappe vers un serveur puisque la conversion se passe en local.
Voilà qui pourrait faciliter la découverte de Pandoc, pourquoi pas conjointement avec un guide comme celui de Christophe Masutti (https://libruniv-c29483.frama.io/)
-->--
#documentation #pandoc #webassembly #html #pdf #latex #odt #wasm
[문서 번역을 정적 결과물이 아닌 버저닝된 소프트웨어 자산으로 다뤄본 경험
대규모 오픈소스 문서 저장소의 번역 자동화 운영 경험을 공유하며, 번역 품질보다 동기화와 상태 관리가 더 중요한 문제임을 강조합니다. 문서가 빠르게 변하는 환경에서 지속 가능한 번역을 유지하는 방법에 대한 인사이트를 제공합니다.
https://news.hada.io/topic?id=26395
#documentation #translation #opensource #automation #versioning
@mwl I can workaround by excluding base and all other options. Still, there was insufficient memory for a simple pkg command:
pkg update -q
– tail of /var/log/messages below.
The apparent hang at ttyv0 might have been a negligible side-effect of my untimely use of --quiet.
A subsequent non-quiet run succeeded,
pkg update
Installation of FreeBSD-set-lib32 succeeded.
Installation of FreeBSD-set-devel failed.
Installation of FreeBSD-set-base failed.
Feb 4 01:35:03 256 pkg[3660]: FreeBSD-zoneinfo-15.0 installed
Feb 4 01:35:03 256 pkg[3660]: FreeBSD-set-minimal-15.0 installed
Feb 4 01:35:05 256 pkg[3660]: pkg-2.4.2 installed
Feb 4 01:35:14 256 kernel: em0: link state changed to DOWN
Feb 4 01:35:16 256 kernel: em0: link state changed to UP
Feb 4 01:35:17 256 dhclient[3861]: New IP Address (em0): 10.0.2.15
Feb 4 01:35:17 256 dhclient[3865]: New Subnet Mask (em0): 255.255.255.0
Feb 4 01:35:17 256 dhclient[3869]: New Broadcast Address (em0): 10.0.2.255
Feb 4 01:35:17 256 dhclient[3873]: New Routers (em0): 10.0.2.2
Feb 4 01:36:55 256 kernel: pid 4223 (pkg), jid 0, uid 0, was killed: failed to reclaim memory
@mwl I get failure to install offline packages – packages are the default with FreeBSD-15.0-RELEASE-amd64-dvd1.iso – with UFS, vm.pageout_oom_seq=120 and 256 MB given to a VirtualBox guest.
The tail of /var/log/messages – after bsdconfig networking (to allow use of termbin.com):
Feb 4 01:05:58 pkg[1652]: FreeBSD-bzip2-lib32-15.0 installed
Feb 4 01:05:58 pkg[1652]: FreeBSD-ccdconfig-15.0 installed
Feb 4 01:05:58 pkg[1652]: FreeBSD-clibs-15.0 installed
Feb 4 01:06:50 kernel: pid 1652 (pkg), jid 0, uid 0, was killed: failed to reclaim memory
Feb 4 01:22:19 kernel: em0: link state changed to DOWN
Feb 4 01:22:21 kernel: em0: link state changed to UP
Feb 4 01:22:25 dhclient[1867]: New IP Address (em0): 10.0.2.15
Feb 4 01:22:25 dhclient[1871]: New Subnet Mask (em0): 255.255.255.0
Feb 4 01:22:25 dhclient[1875]: New Broadcast Address (em0): 10.0.2.255
Feb 4 01:22:25 dhclient[1879]: New Routers (em0): 10.0.2.2
Eyes on ICE: Document and Record (Mass virtual training being offered a second time by national organizers) on Thursday February 5th from 7pm-8pm CT. https://www.mobilize.us/nokings/event/892452 #NoKings #ICE #AntiICE #training #workshop #safety #documentation #protect #immigrants #communities
RE: https://mastodon.social/@yanthomasdev/116008809216558104
I've been so lucky to work alongside @yanthomasdev on @astro 's docs! He says what a lot of us are thinking... and brings the receipts! #documentation
👍 Une nouvelle interprétation passionnante de l’histoire de la Rome antique
https://cltr.blogspot.com/2026/02/une-histoire-de-la-rome-antique.html
#histoire #Rome #Antiquité #SPQR #république #empire #politique #société #livre #documentation #archéologie #archives
Tech writers using AI: what’s the most “confident but wrong” thing you’ve seen it produce in docs?
My take: the key skill isn’t “Can AI write?”
It’s Can we tell when it’s wrong?
https://aitransformer.online/why-can-ai-do-this-is-the-wrong-question-for-technical-writers/
Rollout schedule for the new Aptivi documentation look
As we have stated earlier, we have planned to give our documentation a new look to modernize it and to make it minimal from the start for easier navigation.
The rollout is slated to start on February 15th, with the expected duration of the rollout being three days until the 17th, inclusively. However, there are exceptions applied to some projects.
The following documentation will be updated in this order:
- Projects that will have their documentation updated on February 12th (exception)
- Nitrocid (general rolling docs)
- Terminaux (general rolling docs)
- Projects that will have their documentation updated on February 15th
- BassBoom (general rolling docs)
- SpecProbe
- VisualCard
- Projects that will have their documentation updated on February 16th
- Textify
- Aptivestigate
- Magico
- Colorimetry
- Projects that will have their documentation updated on February 17th
- Nettify
- Metalinker
- ChemiStar
- ResourceLab
- Calendrier
- BskyId
- dotify
- pushrepos
- uprepos
Please note that this is the expected rollout schedule and there may be delays.
Are you excited for the new documentation look?
#Aptivi #documentation #gitbook #news #Tech #Technology #update
Comment Studio for Visual Studio - Enhance XML documentation comments with rich rendering, automatic reflow, collapsing, color-coded tags, and clickable issue links
https://marketplace.visualstudio.com/items?itemName=MadsKristensen.commentsvs
#visualstudio #xmldoc #documentation #codecomments #productivity
Le réseau Médici (Métiers de l'édition scientifique publique) publie sur son site un entretien avec @arthurperret
Il y parle d'édition savante à l'ère du numérique, de l'articulation entre documentation et édition et de ses projets de recherche.
Merci à lui !
#SHS #edition #documentation #numerique
Architecturally-evident Java Applications with jMolecules
https://fosdem.org/2026/schedule/track/tool-the-docs/
--<--
The Tool The Docs devroom focuses on showcasing and advancing free and open-source tools that support the writing, management, testing, rendering, and publishing of documentation.
Documentation is essential for the success of any FOSS project.
This year (2026), we aim to continue supporting the community by connecting contributors with tools that help create clearer, more effective documentation.
In addition to talks about documentation tooling itself, we also welcome sessions that explore adjacent areas, including:
How documentation needs to evolve to take full advantage of Generative AI (GenAI) developments;
The principles behind creating technical content, such as understanding key documentation types and their problem-solving roles;
Information architecture principles for open-source projects.
# Why Present
FOSDEM is one of the world’s largest gatherings of free and open-source contributors, held annually in Brussels, Belgium, at the ULB Campus Solbosch.
Presenting in the Tool The Docs devroom is a unique opportunity to share new ideas, tools, and best practices with a highly technical audience from a wide range of FOSS communities.
We’re looking for talks that cover:
Tools for writing and the principles of effective communication for technical audiences;
Tools for managing documentation;
Tools and methods for testing documentation quality and accuracy;
Tools for automating documentation workflows;
Tools for rendering and publishing documentation;
Open AI tools (as defined by opensource.org/ai) that enhance any of the above areas;
How documentation and discoverability are changing due to large language models (LLMs) and how they reshape how people find and use documentation on the web.
We welcome proposals from those who create, maintain, or work with documentation tools. First-time speakers are welcome!
Please note that product pitches are not allowed at FOSDEM.
Talks should reflect the open-source ethos and contribute to the shared learning of the community.
-->--
I'm struggling to generate a docsite for my Ansible collection. I have followed the guide[1] but the role index is empty. I'll post on the forums as soon as possible.
[1] https://docs.ansible.com/projects/antsibull-docs/collection-docs/
Le café pédagogique | Le média éducation – Le Café pédagogiquecafepedagogique.net@web.brid.gy
2026-02-02David Giacoma : Murder party au collège
5 compulsive thoughts 5 rapids posts #documentation
Client Info
Server: https://mastodon.social
Version: 2025.07
Repository: https://github.com/cyevgeniy/lmst