home.social

#docs — Public Fediverse posts

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

  1. Fluent Bit configuration quick reference and editor

    Fluent Bit’s documentation is spread across many static web pages; in some cases, attributes allowed for a plugin are documented across several pages. There is absolutely nothing wrong with this. Having written a book on Fluent Bit, I can say it makes sense, and if the standard docs went into further detail, it would increase the spread of content.

    The problem is, once you’ve got a grip on Fluent Bit, you want a quick reference just to check the attribute names or confirm that an attribute does what you expect.

    The good news is that’s what we have created …

    Each quick reference page has a section at the top that provides a comma-separated list of all the plugins for the different operations, inputs, outputs, etc., with anchor links to that section. Each plugin has a table that lists all configuration attributes, including those inherited from the Fluent Bit kernel and those introduced by extending another plugin.

    Why and how …

    The “why” may prove even more appealing. As part of our OpAMP project, we wanted to make it easy to edit and validate Fluent Bit and Fluentd configurations before deployment using the OpAMP tooling. That tool became the config-service part of the OpAMP repo, and can be independently deployed as well as function as part of the main OpAMP service. As a result, the UI offers the same authentication and authorisation options, ranging from running without authentication to using OAuth.

    All the different editable components collapsedPlugins part of the editor

    The key to both the UI and documentation is the use of JSON Schemas, as they contain all the information needed to create documentation just as easily as they power the UI. We have therefore generated a markdown page using a Python script. This means the docs are easy to check (compared to an HTML file) and can be rendered within GitHub. We could extend the script to generate HTML. But rather than trying to remember to keep both document types in sync (and double-check formatting), we found a JavaScript tool (marked.js) that performs an on-the-fly transformation that, as long as we stay within the core Markdown syntax, won’t cause any issues. We’ve then enriched that output a bit by applying stylesheets.

    To come…

    At the moment, we have only covered a subset of Fluent Bit versions, so we will, in due course, expand to cover more versions. Today, this is just the last version from each major release. We haven’t done every version to date as it does take a lot of effort to go through the documentation to generate and check the schema, and we’re still refining things as we enhance the UI.

    We are also looking to do the same for Fluentd, though this is much trickier, as the portfolio of plugins that make up the core is smaller than those incorporated into the core of Fluent Bit, and the leveraging of Ruby’s dynamic behaviour makes it very easy for people to offer plugins separately. Then, of course, there is the task of collating all that information.

    Resources

    #AI #docs #FluentBit #Fluentd #GitHub #MCP #Music #OpAMP #youtube
  2. Little change we just made to the docs.python.org/3/ homepage:

    The table on the front is no longer an HTML <table>, but <ul> lists with CSS to make it a grid.

    That's because a <table> should be used for tabular data and not layout.

    This improves accessibility, and also looks better as a list on mobile instead of a squashed table (compare docs.python.org/3.12/).

    dequeuniversity.com/rules/axe/

    #Python #docs #table #accessibility #a11y

  3. Little change we just made to the docs.python.org/3/ homepage:

    The table on the front is no longer an HTML <table>, but <ul> lists with CSS to make it a grid.

    That's because a <table> should be used for tabular data and not layout.

    This improves accessibility, and also looks better as a list on mobile instead of a squashed table (compare docs.python.org/3.12/).

    dequeuniversity.com/rules/axe/

    #Python #docs #table #accessibility #a11y

  4. Little change we just made to the docs.python.org/3/ homepage:

    The table on the front is no longer an HTML <table>, but <ul> lists with CSS to make it a grid.

    That's because a <table> should be used for tabular data and not layout.

    This improves accessibility, and also looks better as a list on mobile instead of a squashed table (compare docs.python.org/3.12/).

    dequeuniversity.com/rules/axe/

    #Python #docs #table #accessibility #a11y

  5. Little change we just made to the docs.python.org/3/ homepage:

    The table on the front is no longer an HTML <table>, but <ul> lists with CSS to make it a grid.

    That's because a <table> should be used for tabular data and not layout.

    This improves accessibility, and also looks better as a list on mobile instead of a squashed table (compare docs.python.org/3.12/).

    dequeuniversity.com/rules/axe/

    #Python #docs #table #accessibility #a11y

  6. Little change we just made to the docs.python.org/3/ homepage:

    The table on the front is no longer an HTML <table>, but <ul> lists with CSS to make it a grid.

    That's because a <table> should be used for tabular data and not layout.

    This improves accessibility, and also looks better as a list on mobile instead of a squashed table (compare docs.python.org/3.12/).

    dequeuniversity.com/rules/axe/

    #Python #docs #table #accessibility #a11y

  7. Google I/O 2026: wielka aktualizacja Google Workspace. Obsługa głosem, potężne Google Pics i inteligentny AI Inbox

    Google Workspace, z którego na całym świecie korzysta ponad 4 miliardy użytkowników, przechodzi najgłębszą integrację ze sztuczną inteligencją w swojej historii.

    Podczas konferencji Google I/O 2026, Yulie Kwon Kim, wiceprezes ds. produktu w zespole Workspace, zaprezentowała rewolucyjne funkcje głosowe z serii „Live”, zupełnie nową aplikację do precyzyjnej edycji grafiki oraz rozszerzenie dostępności inteligentnej skrzynki AI Inbox.

    Oto najważniejsze zmiany, które tego lata trafią do popularnych narzędzi biurowych.

    Obsługa bez użycia rąk: Gmail, Dokumenty i Keep z technologią „Live”

    Nowe funkcje konwersacyjne pozwalają na zarządzanie dokumentami i korespondencją z prędkością ludzkiej mowy. Google stawia na pełną integrację głosową w ramach trzech kluczowych usług:

    • Gmail Live: pozwala na błyskawiczne przeszukiwanie skrzynki odbiorczej za pomocą głosu, co jest idealnym rozwiązaniem podczas podróży. Zamiast ręcznie przeglądać wątki, wystarczy zapytać asystenta na głos: „Z której bramki odlatuje mój samolot?” lub „Co dzieje się w tym tygodniu w szkole mojego dziecka?”, by natychmiast otrzymać precyzyjną odpowiedź.
    • Docs Live: narzędzie to ewoluuje w kierunku wirtualnego współautora tekstów. Pozwala na dyktowanie złożonych konspektów w formie swobodnego strumienia świadomości. System samodzielnie porządkuje myśli, strukturyzuje dokument, a za zgodą użytkownika potrafi w locie pobierać i implementować potrzebne dane z Dysku, Gmaila, Chatu oraz sieci.
    • Keep Live: zwykłe notatki głosowe odchodzą w przeszłość. Keep Live w czasie rzeczywistym analizuje potok słów użytkownika i automatycznie przekształca go w tle w przejrzyste, sformatowane notatki oraz gotowe listy zadań.

    Wymienione funkcje konwersacyjne zostaną udostępnione latem tego roku subskrybentom planów Google AI Pro i Ultra, a klienci biznesowi otrzymają do nich dostęp w wersji podglądowej (Preview).

    Google Pics: pełna kontrola nad grafiką dzięki modelowi Nano Banana

    Kolejną ogromną nowością jest premiera Google Pics – samodzielnego narzędzia do generowania i zaawansowanej edycji obrazów, które bazuje na najnowszym modelu Nano Banana. Projekt ten ma rozwiązać największy problem dotychczasowych generatorów AI – brak powtarzalności i precyzyjnej kontroli nad detalami. Google Pics oferuje m.in.:

    • Segmentację obiektów: użytkownik może precyzyjnie wskazać jeden, konkretny element na zdjęciu lub grafice (np. postać psa lub element garderoby), a następnie go przesunąć, zmienić jego rozmiar lub całkowicie przekształcić, bez jakiegokolwiek wpływu na resztę tła.
    • Edycję i tłumaczenie tekstu: narzędzie pozwala na bezpośrednią modyfikację napisów znajdujących się na grafikach lub ich automatyczne tłumaczenie na inne języki, przy jednoczesnym bezbłędnym zachowaniu oryginalnego stylu czcionki oraz projektu graficznego.

    Aplikacja będzie natywnie zintegrowana z ekosystemem Workspace, pojawiając się w pierwszej kolejności w Prezentacjach oraz na Dysku Google.

    AI Inbox oraz Gemini Spark

    Google ogłosiło również rozszerzenie dostępności funkcji AI Inbox w Gmailu. Narzędzie, które automatycznie priorytetyzuje pocztę i wyciąga najważniejsze wątki, zyskało spersonalizowane, kontekstowe szkice odpowiedzi na pilne wiadomości oraz uproszczony system zarządzania zadaniami. Od dziś funkcja ta przestaje być ekskluzywna dla planu Ultra i trafia do wszystkich subskrybentów planów Google AI Plus oraz Pro w Stanach Zjednoczonych.

    Dopełnieniem całości jest głęboka integracja osobistego, całodobowego agenta Gemini Spark z aplikacjami Workspace. Spark przestaje być jedynie pasywnym doradcą, a staje się aktywnym wykonawcą zadań – potrafi w imieniu użytkownika zarządzać plikami czy zapisywać wydarzenia w kalendarzu, każdorazowo prosząc o wyraźną zgodę przed wykonaniem kluczowej operacji.

    #AI #AIInbox #Docs #GeminiSpark #Gmail #Google #GoogleIO2026 #GooglePics #GoogleWorkspace #iMagazine #KEEP #sztucznaInteligencja #technologia
  8. One of the most useful Red Hat products I use daily is also one of the least-known: the Red Hat Offline Knowledge Portal (RHOKP).

    It is basically a self-hosted, locally searchable mirror of docs.redhat.com + the Red Hat Knowledgebase in a single container image.

    Perfect for:

    - air-gapped environments
    - customer networks with painful proxies
    - trains, planes, and terrible WiFi
    - anyone who wants docs that still work offline

    I wrote up how it works, why I think it matters, and how to run it locally with Podman:

    blog.hofstede.it/red-hat-offli

    #linux #redhat #ansible #openshift #rhokp #docs #devops

  9. One of the most useful Red Hat products I use daily is also one of the least-known: the Red Hat Offline Knowledge Portal (RHOKP).

    It is basically a self-hosted, locally searchable mirror of docs.redhat.com + the Red Hat Knowledgebase in a single container image.

    Perfect for:

    - air-gapped environments
    - customer networks with painful proxies
    - trains, planes, and terrible WiFi
    - anyone who wants docs that still work offline

    I wrote up how it works, why I think it matters, and how to run it locally with Podman:

    blog.hofstede.it/red-hat-offli

    #linux #redhat #ansible #openshift #rhokp #docs #devops

  10. One of the most useful Red Hat products I use daily is also one of the least-known: the Red Hat Offline Knowledge Portal (RHOKP).

    It is basically a self-hosted, locally searchable mirror of docs.redhat.com + the Red Hat Knowledgebase in a single container image.

    Perfect for:

    - air-gapped environments
    - customer networks with painful proxies
    - trains, planes, and terrible WiFi
    - anyone who wants docs that still work offline

    I wrote up how it works, why I think it matters, and how to run it locally with Podman:

    blog.hofstede.it/red-hat-offli

    #linux #redhat #ansible #openshift #rhokp #docs #devops

  11. One of the most useful Red Hat products I use daily is also one of the least-known: the Red Hat Offline Knowledge Portal (RHOKP).

    It is basically a self-hosted, locally searchable mirror of docs.redhat.com + the Red Hat Knowledgebase in a single container image.

    Perfect for:

    - air-gapped environments
    - customer networks with painful proxies
    - trains, planes, and terrible WiFi
    - anyone who wants docs that still work offline

    I wrote up how it works, why I think it matters, and how to run it locally with Podman:

    blog.hofstede.it/red-hat-offli

    #linux #redhat #ansible #openshift #rhokp #docs #devops

  12. One of the most useful Red Hat products I use daily is also one of the least-known: the Red Hat Offline Knowledge Portal (RHOKP).

    It is basically a self-hosted, locally searchable mirror of docs.redhat.com + the Red Hat Knowledgebase in a single container image.

    Perfect for:

    - air-gapped environments
    - customer networks with painful proxies
    - trains, planes, and terrible WiFi
    - anyone who wants docs that still work offline

    I wrote up how it works, why I think it matters, and how to run it locally with Podman:

    blog.hofstede.it/red-hat-offli

    #linux #redhat #ansible #openshift #rhokp #docs #devops

  13. 🐍 Michigan Python is meeting tonight!

    @kattni is joining us to talk about upgrading your Python docs by switching from Sphinx to Markdown.

    🗓 Thursday, May 7, 7pm ET
    📍 Cahoots Coworking, Ann Arbor, or join online

    All are welcome!

    meetup.com/michigan-python/eve

  14. J'ai oublié de vous dire, mais il y a la version 4.8.6 de @lasuite Docs qui est à jour depuis @yunohost et qui corrige le problème d'intégration d'images dans un document.
    Vous n'avez plus d'excuses pour quitter Google Docs ;-) 👉 github.com/YunoHost-Apps/lasui

    Merci à @florent et poke à @numerique_gouv @sampaccoud @ppezziardi et bien sûr @virdev

    #SouverainetéNumérique #Docs #LaSuite #DINUM #AutonomieStratégique #Bureautique

  15. J'ai oublié de vous dire, mais il y a la version 4.8.6 de @lasuite Docs qui est à jour depuis @yunohost et qui corrige le problème d'intégration d'images dans un document.
    Vous n'avez plus d'excuses pour quitter Google Docs ;-) 👉 github.com/YunoHost-Apps/lasui

    Merci à @florent et poke à @numerique_gouv @sampaccoud @ppezziardi et bien sûr @virdev

    #SouverainetéNumérique #Docs #LaSuite #DINUM #AutonomieStratégique #Bureautique

  16. J'ai oublié de vous dire, mais il y a la version 4.8.6 de @lasuite Docs qui est à jour depuis @yunohost et qui corrige le problème d'intégration d'images dans un document.
    Vous n'avez plus d'excuses pour quitter Google Docs ;-) 👉 github.com/YunoHost-Apps/lasui

    Merci à @florent et poke à @numerique_gouv @sampaccoud @ppezziardi et bien sûr @virdev

    #SouverainetéNumérique #Docs #LaSuite #DINUM #AutonomieStratégique #Bureautique

  17. J'ai oublié de vous dire, mais il y a la version 4.8.6 de @lasuite Docs qui est à jour depuis @yunohost et qui corrige le problème d'intégration d'images dans un document.
    Vous n'avez plus d'excuses pour quitter Google Docs ;-) 👉 github.com/YunoHost-Apps/lasui

    Merci à @florent et poke à @numerique_gouv @sampaccoud @ppezziardi et bien sûr @virdev

    #SouverainetéNumérique #Docs #LaSuite #DINUM #AutonomieStratégique #Bureautique

  18. J'ai oublié de vous dire, mais il y a la version 4.8.6 de @lasuite Docs qui est à jour depuis @yunohost et qui corrige le problème d'intégration d'images dans un document.
    Vous n'avez plus d'excuses pour quitter Google Docs ;-) 👉 github.com/YunoHost-Apps/lasui

    Merci à @florent et poke à @numerique_gouv @sampaccoud @ppezziardi et bien sûr @virdev

    #SouverainetéNumérique #Docs #LaSuite #DINUM #AutonomieStratégique #Bureautique

  19. Just released: Python Docs Sphinx Theme 2026.4! 🚀

    This is the theme for the Python documentation (and others). This release:

    * Adds styling for the `soft-deprecated` class
    * Adds a Tamil translation
    * Fixes the vertical alignment of `:Editor:`

    Thanks to @hugovk for helping me with my first release!

    github.com/python/python-docs-

    #python #docs #theme #release #Sphinx

  20. Just released: Python Docs Sphinx Theme 2026.4! 🚀

    This is the theme for the Python documentation (and others). This release:

    * Adds styling for the `soft-deprecated` class
    * Adds a Tamil translation
    * Fixes the vertical alignment of `:Editor:`

    Thanks to @hugovk for helping me with my first release!

    github.com/python/python-docs-

    #python #docs #theme #release #Sphinx

  21. Just released: Python Docs Sphinx Theme 2026.4! 🚀

    This is the theme for the Python documentation (and others). This release:

    * Adds styling for the `soft-deprecated` class
    * Adds a Tamil translation
    * Fixes the vertical alignment of `:Editor:`

    Thanks to @hugovk for helping me with my first release!

    github.com/python/python-docs-

    #python #docs #theme #release #Sphinx

  22. Just released: Python Docs Sphinx Theme 2026.4! 🚀

    This is the theme for the Python documentation (and others). This release:

    * Adds styling for the `soft-deprecated` class
    * Adds a Tamil translation
    * Fixes the vertical alignment of `:Editor:`

    Thanks to @hugovk for helping me with my first release!

    github.com/python/python-docs-

    #python #docs #theme #release #Sphinx

  23. Just released: Python Docs Sphinx Theme 2026.4! 🚀

    This is the theme for the Python documentation (and others). This release:

    * Adds styling for the `soft-deprecated` class
    * Adds a Tamil translation
    * Fixes the vertical alignment of `:Editor:`

    Thanks to @hugovk for helping me with my first release!

    github.com/python/python-docs-

    #python #docs #theme #release #Sphinx

  24. 📚 OSRM’s API documentation just got a fresh new look!

    Clean design, easy navigation, and all six services covered — Route, Table, Map Matching, Trip Planning, Nearest, and Tile. Whether you’re just getting started or looking something up, it’s never been nicer to use. 🗺️✨

    👉 project-osrm.org/docs/

    #OSRM #OpenStreetMap #Routing #OpenSource #Docs

  25. 📚 OSRM’s API documentation just got a fresh new look!

    Clean design, easy navigation, and all six services covered — Route, Table, Map Matching, Trip Planning, Nearest, and Tile. Whether you’re just getting started or looking something up, it’s never been nicer to use. 🗺️✨

    👉 project-osrm.org/docs/

    #OSRM #OpenStreetMap #Routing #OpenSource #Docs

  26. 📚 OSRM’s API documentation just got a fresh new look!

    Clean design, easy navigation, and all six services covered — Route, Table, Map Matching, Trip Planning, Nearest, and Tile. Whether you’re just getting started or looking something up, it’s never been nicer to use. 🗺️✨

    👉 project-osrm.org/docs/

    #OSRM #OpenStreetMap #Routing #OpenSource #Docs

  27. 📚 OSRM’s API documentation just got a fresh new look!

    Clean design, easy navigation, and all six services covered — Route, Table, Map Matching, Trip Planning, Nearest, and Tile. Whether you’re just getting started or looking something up, it’s never been nicer to use. 🗺️✨

    👉 project-osrm.org/docs/

    #OSRM #OpenStreetMap #Routing #OpenSource #Docs

  28. 📚 OSRM’s API documentation just got a fresh new look!

    Clean design, easy navigation, and all six services covered — Route, Table, Map Matching, Trip Planning, Nearest, and Tile. Whether you’re just getting started or looking something up, it’s never been nicer to use. 🗺️✨

    👉 project-osrm.org/docs/

    #OSRM #OpenStreetMap #Routing #OpenSource #Docs

  29. Love high-quality cinema but tired of the big streaming giants?

    I'm really enjoying Japanese Film Festival Online (JFF+): I watched a couple of good #movies and #docs this week. 🇯🇵

    Well: the web is probably full of "hidden digital cinematheques" run by cultural institutes and archives that offer #free, legal #streaming.

    Here’s a list of gems to feed your cinephile soul this weekend.
    #Cinema #Cinephile #Streaming #FreeCulture #Film

    it.jff.jpf.go.jp/

    🧵

  30. 𝗗𝗼𝗰𝘀:

    #Documentation #Collaborative #Docs

    thewhale.cc/posts/docs

    A collaborative note taking, wiki and documentation platform that scales. Built with Django and React. Opensource alternative to Notion or Outline.

  31. de nieuwe toepassing in @protonmail en @ProtonDrive #Docs en #Sheets zijn in feite microsoft clones van #word en #excel

    maar geen #odf en #ods ondersteuning‼️

    documenten en spreadsheets uit bijvoorbeeld @libreoffice en #openoffice zijn niet in te lezen in Proton - die moeten eerst geconverteerd worden naar word en excel formats - - hmmmm, niet goed

    en dat voor een Zwitsers bedrijf - -
    en dat in een tijd waar soevereiniteit een #hotitem is - -
    en dat is niet plotseling vandaag actueel - -
    dit speelt al jaren - -

  32. de nieuwe toepassing in @protonmail en @ProtonDrive #Docs en #Sheets zijn in feite microsoft clones van #word en #excel

    maar geen #odf en #ods ondersteuning‼️

    documenten en spreadsheets uit bijvoorbeeld @libreoffice en #openoffice zijn niet in te lezen in Proton - die moeten eerst geconverteerd worden naar word en excel formats - - hmmmm, niet goed

    en dat voor een Zwitsers bedrijf - -
    en dat in een tijd waar soevereiniteit een #hotitem is - -
    en dat is niet plotseling vandaag actueel - -
    dit speelt al jaren - -

  33. #Video-Call with E2E #encryption
    This is probably the most important update along with their support for #Docs for anyone in a sensitive space, like #medical. Especially when having a conversation with your #therapist over a video call. Or even when storing your personal #documents.
    meet.proton.me/

  34. #Video-Call with E2E #encryption
    This is probably the most important update along with their support for #Docs for anyone in a sensitive space, like #medical. Especially when having a conversation with your #therapist over a video call. Or even when storing your personal #documents.
    meet.proton.me/

  35. I’m experimenting with a new setup to rebuild the @silex docs

    I like how Webflow (eg university.webflow.com/course- ) does video docs

    but I'm a text first kind of guy

    so I’m thinking:

    - rewrite the docs as exhausive structured text docs first
    - turn them into audio with TTS (probably Voxtral TTS - open-weight - thx @BeginnersInAi )
    - then record the videos on top

    basically text → audio → video

    not sure if this the way to go?

    #buildinpublic #docs #webdev #silex #foss #opensource #nocode

  36. I've been testing #zensical since I will have to migrate off of #mkdocs and #mkdocsmaterial.

    Across 3 sites, I only had to change one line in the yaml files and run `zensical` instead of `mkdocs`. Total potential migration time for 3 sites, 10 minutes.

    Why potential and not complete? Pending blog and OpenAPI spec support. Once those are released, I can finish testing and migrate.

    @squidfunk looking good so far. Thanks!

    #technology #tech #indieweb #blog #technicalwriting #docs #docsascode

  37. I've been testing #zensical since I will have to migrate off of #mkdocs and #mkdocsmaterial.

    Across 3 sites, I only had to change one line in the yaml files and run `zensical` instead of `mkdocs`. Total potential migration time for 3 sites, 10 minutes.

    Why potential and not complete? Pending blog and OpenAPI spec support. Once those are released, I can finish testing and migrate.

    @squidfunk looking good so far. Thanks!

    #technology #tech #indieweb #blog #technicalwriting #docs #docsascode

  38. I've been testing #zensical since I will have to migrate off of #mkdocs and #mkdocsmaterial.

    Across 3 sites, I only had to change one line in the yaml files and run `zensical` instead of `mkdocs`. Total potential migration time for 3 sites, 10 minutes.

    Why potential and not complete? Pending blog and OpenAPI spec support. Once those are released, I can finish testing and migrate.

    @squidfunk looking good so far. Thanks!

    #technology #tech #indieweb #blog #technicalwriting #docs #docsascode

  39. I've been testing #zensical since I will have to migrate off of #mkdocs and #mkdocsmaterial.

    Across 3 sites, I only had to change one line in the yaml files and run `zensical` instead of `mkdocs`. Total potential migration time for 3 sites, 10 minutes.

    Why potential and not complete? Pending blog and OpenAPI spec support. Once those are released, I can finish testing and migrate.

    @squidfunk looking good so far. Thanks!

    #technology #tech #indieweb #blog #technicalwriting #docs #docsascode