home.social

#documentation — Public Fediverse posts

Live and recent posts from across the Fediverse tagged #documentation, aggregated by home.social.

fetched live
  1. I have restructured the speedata Publisher manual, because there was something missing in the manual, although I thought it was complete. After some research I found out about the Diátaxis model for technical writing which analyses the documentation usage.

    See here for a writeup:
    news.speedata.de/2026/08/13/di

    #tecdoc #speedatapublisher #documentation

  2. 🎉 BREAKING: #DeepSeek #V4 #Pro 0813 was oh-so-quietly released, but who cares? Just another inscrutable #API #documentation dump full of gobbledygook about "Response APIs" and "Codex" that only a robot could love 🤖💤. Congratulations, you've managed to make tech jargon even less comprehensible! 🙄🔍
    api-docs.deepseek.com/guides/r #Release #TechJargon #Codex #RobotLove #HackerNews #ngated

  3. Docs always drifting out of sync with your code? 🧩

    New open-source agent skill — docs-update-expert: reconciles README, CHANGELOG, AGENTS.md, API references & inline comments with your repo's actual state. It builds a git-based drift map, edits surgically, and never fabricates facts.

    skills.sh/ricardodantas/skills

    #DevTools #AI #Documentation #OpenSource #DevEx #AITools

  4. @ariadne @malte @delta OFC.

    And we have to up the game.re: #documentation so everyone can use stuff with step-by-step tutorials!

  5. #MissKittyRaw
    I love getting added to #AI #moderation lists when the #documentation I deliver is as good as you can find on the network. I just love people that are unwilling to learn, and think that they know something, and they live inside of a delirium created by non-engagement with #facts.

  6. Making the PostgreSQL Documentation Even Better

    If you'd like to actively help improve the #PostgreSQL #documentation: Here's how I went about it:

    fromdual.com/blog/postgresql/i

  7. 🌑 Tomorrow’s solar eclipse will hide something huge in plain sight.

    Beautiful in the sky.

    Less beautiful in a wiki. 😅

    In organizations, knowledge gets eclipsed too:

    Outdated pages bury current ones.
    Decisions disappear in meeting notes.
    Updates stay in chat.
    Rights no longer match how teams work.

    💡 A good wiki brings knowledge back into view.

    try.xwiki.com

    #XWiki #OpenSource #KnowledgeManagement #Documentation #SelfHosting

    try.xwiki.com

  8. Remembering the time I read the #MSDOS 3.21 manual to figure out why our Zenith Data Systems 286 no longer booted from the 20 MB hard disk and concluded the solution was "format c: /s"

    when what I actually needed could be done with "sys c:"

    (to just copy the system files over w/o wiping the entire drive)

    I still blame the manual. I read the #documentation carefully and came to that conclusion after much deliberation.

    My mother was remarkably understanding, in retrospect. (It was her PC.)

  9. Starting the new week off by sharing the news that ToC improvements for Docsify-This and the Docsify Starter Kits is coming 🎉

    ✅️ On mobile, the ToC is now a collapsible "On this page" accordion instead of an always-open list
    ✅️ Padding/alignment now match your site's own content styling
    ✅️ Consistent behavior across Docsify-This and the Starter Kits

    Can't wait? See it in action on mobile at:
    docsify-this.net/?basePath=htt

    #Docsify #OpenSource #EdTech #WebDev #Documentation

  10. #ParkrosePermaculture #safety #privacy #documentation #whitnessvideo #ICE #men #fascism #stopfascism #nazis #fcknazis #protest #democracy

    THIS!
    "PUBLIC OFFICIALS have no expectation of privacy while doing their jobs. PRIVATE CITIZEN have every expectation of privacy."

    BUT also: document ALL#perpetrators! There is no right for privacy for ANY perpetrator.

    youtu.be/qYOihkIZxcU

  11. Finally getting some traction on adopting #towncrier into my projects.

    I've been dragging my heels for 6 months as auditing the git logs of ~20 4 year old projects has been terribly daunting/overwhelming.

    Just going to have to be more diligent going forward with documenting changes.
    Lesson learned.

    It's not really "self-documenting" until you actually document it. derp.🤪

    #Python #Changelog #documentation

  12. Compare CommonMark, GitHub Flavored Markdown, and Pandoc Markdown syntax, including tables, footnotes, math, metadata, and portability.

    #Markdown #Hugo #documentation #wiki

    glukhov.org/documentation-tool

  13. Outdated page.
    Broken link.
    Owner left.
    Decision buried in a recording.
    Permission request pending.
    “Can someone send me the file?”

    Funny, until work slows down.

    Good documentation is not just storage. It is shared access, ownership, context, and trust.

    What square would you add?

    #XWiki #OpenSource #KnowledgeManagement #Documentation

  14. Heute auf‘m Bücher-Flohmarkt an der Uni für sage und schreibe einen Euro erstanden: BBC-Doku von 2011 über das Ende der römischen Republik...

    #roman #römisch #römischerepublik #romanrepublic #doku #documentation #bbc #geschichte #history

  15. Our documentation has just been updated. Check e.g.

    * izzyondroid.org/about/security to see how automated updates are handled (and "risky APKs" get quarantined)
    * izzyondroid.org/docs/general/F for a hopefully easier to understand description on formatting app descriptions
    * izzyondroid.org/docs/devpracti for a new hint to Flutter devs on how to implement location handling without Google Services

    We hope this is helpful for you, and you can enjoy it 🤗

    #IzzyOnDroid #documentation