home.social

#readme — Public Fediverse posts

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

  1. In unserem neuen #readme-Interview berichten Carolin Fleischer-Heininger vom #DIJTokyo und Kevin Schumacher-Shoji von der #LMU, wie in der japanischen Literatur kulturelle Bedeutungen beim Übersetzen verloren gehen oder neu entstehen können.

    🔗 Zum Interview: gab.hypotheses.org/22431

    #Buchverlosung 🎁 | Unter allen, die diesen Beitrag hier, bei BlueSky, Instagram, Facebook oder LinkedIn bis zum 22.04.2026 kommentieren oder liken, verlosen wir ein Printexemplar des Buches!

  2. "The people best positioned to configure AI agents like Claude Code aren't engineers. They're technical writers.

    It's a bold claim, so let me back it up.

    Here's a file that powers an AI agent:

    AGENTS.md

    # AGENTS.md — API Documentation Repository

    ## Workflow Rules

    - Human review required for API reference changes
    - Style guide compliance checked automatically via CI
    - Maximum 3 AI revision cycles before human takeover

    ## Escalation

    - Writer agent fails after 3 attempts → human writer takes over
    - Reviewer agent flags accuracy concern → SME review required
    Markdown syntax, structured headings, rules about workflows and handoffs. If you've written a README, a style guide, or onboarding documentation, this looks familiar because it that's effectively what it is. The files that configure AI agents are Markdown files with structured frontmatter. They're documentation.

    The difference is the audience: instead of a human colleague, you're writing for an AI model that's highly knowledgeable but has zero institutional memory. The challenge is one technical communicators already navigate: deciding what to include, how to structure it, and what level of detail serves the reader.

    So what kinds of files are involved?"

    instructionmanuel.com/agent-co

    #TechnicalWriting #AI #LLMs #AIAgents #AgenticAI #TechnicalCommunication #Markdown #README

  3. I've published my first Action to the GitHub Marketplace. It's a very simple tool (as all the best ones are!) that takes your repo's README and converts it to HTML for use in a GitHub Pages website. It scratched a very particular itch for me, but it might be useful to other people, too.

    dev.to/davorg/your-readme-is-a

  4. @blyxyas I by no means am comparing between your to mine. But I can honestly relate to your comment about the . There have been when I came up with only to find my past created that I completely forgot about. Realizing that it wasn’t a new idea after all Going through the and the left me and

  5. 🎨💻 Behold, the revolutionary library of bubble-shaped icons to elevate your developer street cred! Because, clearly, your coding prowess is defined by the cuteness of your #GitHub #README. 🙄✨
    github.com/YuheshPandian/ICONIC #bubbleicons #developercred #designtrends #codinghumor #HackerNews #ngated

  6. #README: Brief #introduction :logo_epfl: :epfl_sti:
    I’m an #adminIT focused on #SML & #LMOM labs (#STI / #EPFL) open to advance other projects/groups too.
    current load: 50% CPU - two threads free, ready to fork.🖥️

    Otherwise,
    I capture our scientific worlds in images.
    #EPFLsciencephotography @epflphotography

    #sciencephotography, #sciencephotograher
    #macro #liquids #metals #materials #powders

  7. #README : Brève #introduction :logo_epfl: :epfl_sti:
    Je suis #adminIT dans les labos {#SML, #LMOM} @ #STI / #EPFL – dispo et enthousiaste pour contribuer à d’autres projets en soutien informatique ou photo.
    cad.: charge actuelle : 50% CPU – 2x thread libre, prêt à forker.🖥️

    Autrement,
    je capture nos mondes scientifiques en images.
    #EPFLsciencephotography @epflphotography

    #sciencephotography
    #sciencephotographer

  8. I finally got around to making a more or less generic sketch to demonstrate the #MutableInstruments Braids port to arduino. It's at github.com/poetaster/arduinoMI with minimal instructions in the Repo #README It's a real challenge getting decent audio output but Braids is nice and rings is nice. Plaits is still a bit bitchy, but, somewhat usable :) here is an example of what usable means (abusing FM)

  9. Проброс сайта, не имеющего глобального IP-а́дреса, из локальной сети на свой сервер в Интернете (обратный прокси) через сеть Yggdrasil
    multed.com/2024/04/03/nginx-an

    #HTTP #сайт #IP #IPv4 #IPv6 #IP_адрес #сеть #LAN #LAN #сервер #VPS #VDS #Интернет #Yggdrasil #nginx #proxy #reverseproxy #reverse_proxy #publicpeer #сисадмин #лайфхак #readme

  10. 🔴 🚀 Nouveauté chez Arawa ! Nous sommes ravis d'annoncer la publication de notre guide 🇫🇷 pour les utilisateurs de #Nextcloud sur #GitHub ! 📚 Disponible sous licence CC BY-NC-SA, ce guide couvre déjà Nextcloud 27 et 28. 🌐 N'hésitez pas à le consulter et à le partager ! 🧩 Vos contributions sont les bienvenues (merci de lire le #ReadMe de la page GitHub avant de contribuer).
    👋 @nextcloud
    #️⃣ #OpenSource #LogicielsLibres #UserGuide #CreativeCommons #CCBYNCSA
    github.com/arawa/guides-utilis