helvede.net is one of the many independent Mastodon servers you can use to participate in the fediverse.
Velkommen til Helvede, fediversets hotteste instance! Vi er en queerfeministisk server, der shitposter i den 9. cirkel. Welcome to Hell, We’re a DK-based queerfeminist server. Read our server rules!

Server stats:

161
active users

#docs

0 posts0 participants0 posts today
Klaus Frank<p>Sometimes you should just run "modinfo" against random files within "/lib/modules/*/kernel/**".</p><p>The linux kernel documentation has such a bad SEO that you literally won't find most of the gems hiding in there without reading the description of the modules....</p><p>E.g. try to search for how to configure a load spreader (aka tap/duplicate traffic to multiple destinations).<br>EVERYTHING google points you to either says it is impossible or to use tc.</p><p>But nft_dup_netdev is NEVER mentioned.<br><a href="https://chaos.social/tags/linux" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>linux</span></a> <a href="https://chaos.social/tags/docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>docs</span></a></p>
Miguel Afonso Caetano<p>"You can replace tech writers with an LLM, perhaps supervised by engineers, and watch the world burn. Nothing prevents you from doing that. All the temporary gains in efficiency and speed would bring something far worse on their back: the loss of the understanding that turns knowledge into a conversation. Tech writers are interpreters who understand the tech and the humans trying to use it. They’re accountable for their work in ways that machines can’t be.</p><p>The future of technical documentation isn’t replacing humans with AI but giving human writers AI-powered tools that augment their capabilities. Let LLMs deal with the tedious work at the margins and keep the humans where they matter most: at the helm of strategy, tending to the architecture, bringing the empathy that turns information into understanding. In the end, docs aren’t just about facts: they’re about trust. And trust is still something only humans can build."</p><p><a href="https://passo.uno/whats-wrong-ai-generated-docs/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">passo.uno/whats-wrong-ai-gener</span><span class="invisible">ated-docs/</span></a></p><p><a href="https://tldr.nettime.org/tags/AI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>AI</span></a> <a href="https://tldr.nettime.org/tags/GenerativeAI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GenerativeAI</span></a> <a href="https://tldr.nettime.org/tags/LLMs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>LLMs</span></a> <a href="https://tldr.nettime.org/tags/Chatbots" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Chatbots</span></a> <a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalWriting</span></a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalCommunication</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SoftwareDocumentation</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SoftwareDevelopment</span></a> <a href="https://tldr.nettime.org/tags/TechnicalDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalDocumentation</span></a> <a href="https://tldr.nettime.org/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docs</span></a></p>
Open Source Politics<p>La Suite.coop, c'est quoi ?</p><p>- Un écosystème d'outils open source puissants (dont <a href="https://mastodon.indie.host/tags/Grist" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Grist</span></a> et <a href="https://mastodon.indie.host/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docs</span></a>) pour booster votre productivité.<br>- Une collaboration renforcée avec des partenaires comme <span class="h-card"><a href="https://mastodon.scop.coop/@hashbang" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>hashbang</span></a></span> et <span class="h-card"><a href="https://toot.aquilenet.fr/@yaal" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>yaal</span></a></span> pour construire un numérique plus juste et transparent.<br>- Une offre modulaire sur mesure<br>- Une alternative aux géants du web </p><p>Associations, coopératives, entreprises ESS, institutions, universités : il est temps de changer la donne ! Rejoignez le mouvement !</p><p>👉 <a href="https://www.lasuite.coop/" rel="nofollow noopener noreferrer" target="_blank"><span class="invisible">https://www.</span><span class="">lasuite.coop/</span><span class="invisible"></span></a></p>
Hugo van Kemenade<p>The Python version diagram has been updated to show the bugfix/security split for each release. (Before, the bars were either completely green or yellow.)</p><p><a href="https://devguide.python.org/versions/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">devguide.python.org/versions/</span><span class="invisible"></span></a></p><p>It's also zoomed in and shows fewer releases than before. There's another chart further down the page showing all of 2.6 to 3.14. And the wording in the status key has been refreshed to make it clearer.</p><p>Thanks to <span class="h-card" translate="no"><a href="https://hachyderm.io/@nedbat" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>nedbat</span></a></span> and <span class="h-card" translate="no"><a href="https://mastodon.social/@encukou" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>encukou</span></a></span> for updating it!</p><p><a href="https://mastodon.social/tags/Python" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Python</span></a> <a href="https://mastodon.social/tags/CPython" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>CPython</span></a> <a href="https://mastodon.social/tags/EOL" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>EOL</span></a> <a href="https://mastodon.social/tags/devguide" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>devguide</span></a> <a href="https://mastodon.social/tags/docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>docs</span></a></p>
eerlijkdigitaalonderwijs.nl<p><span class="h-card" translate="no"><a href="https://social.v.st/@becha" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>becha</span></a></span> <span class="h-card" translate="no"><a href="https://eupolicy.social/@jmaris" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>jmaris</span></a></span> <span class="h-card" translate="no"><a href="https://social.notjustbikes.com/@notjustbikes" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>notjustbikes</span></a></span> <span class="h-card" translate="no"><a href="https://mastodon.xyz/@nextcloud" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>nextcloud</span></a></span> <span class="h-card" translate="no"><a href="https://fosstodon.org/@cryptpad" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>cryptpad</span></a></span> <span class="h-card" translate="no"><a href="https://framatube.org/accounts/framasoft" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>framasoft</span></a></span> <span class="h-card" translate="no"><a href="https://openedtech.social/@moodle" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>moodle</span></a></span> <br>A lot of people are now enthusiast about <a href="https://mastodon.nl/tags/docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>docs</span></a> , but it has the wrong license: MIT . <a href="https://github.com/suitenumerique/docs" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">github.com/suitenumerique/docs</span><span class="invisible"></span></a></p><p>Meaning, as soon as it becomes popular, it wil be available from <a href="https://mastodon.nl/tags/Amazon" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Amazon</span></a> <a href="https://mastodon.nl/tags/AWS" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>AWS</span></a> branded AmazonDocs, ready for ordering in one click.</p><p>And <a href="https://mastodon.nl/tags/JeffBezos" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>JeffBezos</span></a> won't say thank you for developing.</p>
Peter Suber<p>I like the idea of <a class="hashtag" href="https://bsky.app/search?q=%23Docs" rel="nofollow noopener noreferrer" target="_blank">#Docs</a>, an <a class="hashtag" href="https://bsky.app/search?q=%23OpenSource" rel="nofollow noopener noreferrer" target="_blank">#OpenSource</a> alternative to G Docs developed by the French &amp; German govts, compliant with <a class="hashtag" href="https://bsky.app/search?q=%23GDPR" rel="nofollow noopener noreferrer" target="_blank">#GDPR</a>, and hosted outside the US. <a href="https://docs.numerique.gouv.fr" rel="nofollow noopener noreferrer" target="_blank">docs.numerique.gouv.fr</a> But I'm having trouble finding reviews, perhaps bc it's new or bc it has such a generic name. Can anyone point to reviews?<br><br><a href="https://docs.numerique.gouv.fr" rel="nofollow noopener noreferrer" target="_blank">Docs</a></p>
petersuber<p>I like the idea of <a href="https://fediscience.org/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docs</span></a>, an <a href="https://fediscience.org/tags/OpenSource" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenSource</span></a> alternative to Google Docs developed by the French and German governments, compliant with <a href="https://fediscience.org/tags/GDPR" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GDPR</span></a>, and hosted outside the US.<br><a href="https://docs.numerique.gouv.fr" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">docs.numerique.gouv.fr</span><span class="invisible"></span></a></p><p>But I'm having trouble finding reviews, perhaps because it's new or because it has such a generic name. Can anyone point to helpful reviews?</p>
Sebastian Büttrich @ ITU<p><span class="h-card" translate="no"><a href="https://helvede.net/@tofticles" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>tofticles</span></a></span> <span class="h-card" translate="no"><a href="https://mastodon.social/@ErikJonker" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>ErikJonker</span></a></span> </p><p>it seems for now you need a french VAT registration to register (?) - or is my french zu schlecht?</p><p><a href="https://social.itu.dk/tags/opensource" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>opensource</span></a> <a href="https://social.itu.dk/tags/opendoc" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>opendoc</span></a> <a href="https://social.itu.dk/tags/docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>docs</span></a></p>
Erik Jonker<p>Interesting:<br>Docs is the result of a joint effort lead by the French 🇫🇷🥖(DINUM) and German 🇩🇪🥨 governments (ZenDiS). We are always looking for new public partners (we are currently onboarding the Netherlands 🇳🇱🧀). Feel free to reach out if you are interested in using or contributing to docs.</p><p><a href="https://docs.numerique.gouv.fr/login/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">docs.numerique.gouv.fr/login/</span><span class="invisible"></span></a></p><p><a href="https://mastodon.social/tags/docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>docs</span></a> <a href="https://mastodon.social/tags/opensource" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>opensource</span></a> <a href="https://mastodon.social/tags/eu" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>eu</span></a> <a href="https://mastodon.social/tags/europe" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>europe</span></a> <a href="https://mastodon.social/tags/france" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>france</span></a> <a href="https://mastodon.social/tags/germany" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>germany</span></a> <a href="https://mastodon.social/tags/netherlands" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>netherlands</span></a> <a href="https://mastodon.social/tags/collaboration" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>collaboration</span></a> <a href="https://mastodon.social/tags/fosdem" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>fosdem</span></a></p>
Hacker News<p>French gov's open source alternative to Notion or Outline</p><p><a href="https://github.com/suitenumerique/docs" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">github.com/suitenumerique/docs</span><span class="invisible"></span></a></p><p><a href="https://mastodon.social/tags/HackerNews" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>HackerNews</span></a> <a href="https://mastodon.social/tags/FrenchGov" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>FrenchGov</span></a> <a href="https://mastodon.social/tags/OpenSource" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenSource</span></a> <a href="https://mastodon.social/tags/Notion" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Notion</span></a> <a href="https://mastodon.social/tags/Alternative" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Alternative</span></a> <a href="https://mastodon.social/tags/SuiteNumerique" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SuiteNumerique</span></a> <a href="https://mastodon.social/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docs</span></a></p>
Miguel Afonso Caetano<p>"[T]he lack of a clear entry path makes the profession less accessible, contributing to a lack of diversity in tech writing teams. If technical writing is to remain relevant in an industry that values innovation and inclusion, it needs to welcome new voices.</p><p>Fixing this problem won’t happen overnight, but there are steps companies and the broader industry can take to rebuild the pipeline for entry-level talent:</p><p>- Reintroduce mentorship programs.<br>- Companies can pair senior writers with juniors to share knowledge and help newcomers build confidence.<br>- Redefine “entry-level” roles.<br>- Stop asking for years of experience in entry-level job postings. - Focus instead on transferable skills like writing, research, and adaptability.<br>- Create apprenticeships or internships.<br>- Paid opportunities to learn on the job can give aspiring writers the experience they need to land full-time roles.<br>Invest in training.<br>- Documentation teams should have budgets for upskilling new hires — not just hiring pre-trained professionals."</p><p><a href="https://willkelly.medium.com/how-the-technical-writing-profession-betrayed-entry-level-tech-writers-8a0c05617efd" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">willkelly.medium.com/how-the-t</span><span class="invisible">echnical-writing-profession-betrayed-entry-level-tech-writers-8a0c05617efd</span></a></p><p><a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalWriting</span></a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalCommunication</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SoftwareDocumentation</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SoftwareDevelopment</span></a> <a href="https://tldr.nettime.org/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docs</span></a> <a href="https://tldr.nettime.org/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Documentation</span></a></p>
Miguel Afonso Caetano<p>“Fortunately, I think there’s a good alternative to the dismal picture of brain-dead tech writers pressing buttons on AI machines and passing the content to SMEs for review. That alternative is to focus on what AI algorithms can’t do (at least not with a few button clicks). In this revised approach, tech writers offload the simple tasks to AI tools to fix while focusing their real time and energy on more complex, ambitious tasks that are beyond the straightforward capabilities of AI tools.</p><p>When I say beyond AI capabilities, I still mean AI tools might assist or augment tech writers in the work; it’s just that the tasks aren’t as simple as the mechanical tasks of fixing doc bugs that I described earlier (e.g., “what’s the issue? what’s the fix?”).</p><p>For example, when I set about creating complex tree diagrams showing all elements in an API, this was a new kind of documentation that hadn’t been done before at my company. It became an instant hit and one that proved challenging to maintain and grow and fix, but still worthwhile. (In fact, in a chat with a product manager last week, he wondered if our tree diagram page wasn’t the most popular page in our documentation.)</p><p>If we focused more on these sophisticated tasks (beyond click-button AI), I think tech writers could have a brighter future.”</p><p><a href="https://idratherbewriting.com/blog/recursive-self-improvement-complex-tasks" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">idratherbewriting.com/blog/rec</span><span class="invisible">ursive-self-improvement-complex-tasks</span></a></p><p><a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalWriting</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SoftwareDocumentation</span></a> <a href="https://tldr.nettime.org/tags/APIDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>APIDocumentation</span></a> <a href="https://tldr.nettime.org/tags/AI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>AI</span></a> <a href="https://tldr.nettime.org/tags/GenerativeAI" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GenerativeAI</span></a> <a href="https://tldr.nettime.org/tags/LLMs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>LLMs</span></a> <a href="https://tldr.nettime.org/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docs</span></a></p>
Gareth Halfacree<p>Started seeing the pernicious Gemini AI button appear in Google Docs, Sheets, and the rest of 'em? Got uBlock Origin?</p><p>Here's the filter you need:</p><p>##<a href="https://mastodon.social/tags/docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>docs</span></a>-sidekick-gen-ai-promo-button-container</p>
Darrell Hilliker 👨‍🦯♾️📡<p>I think <a href="https://mastodon.online/tags/JAWS" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>JAWS</span></a> semi-auto Forms Mode might just be my new best friend. It does a great job in web apps like <a href="https://mastodon.online/tags/Google" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Google</span></a> <a href="https://mastodon.online/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docs</span></a> and <a href="https://mastodon.online/tags/Salesforce" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Salesforce</span></a> allowing smooth operation while tabbing and preserving my ability to use arrow keys and quick single-character navigation with the virtual PC cursor. I was skeptical until I tried it to work around an issue I was experiencing opening documents. But now I also find it works great in <a href="https://mastodon.online/tags/GMail" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GMail</span></a>'s message list and interactive grids like those used in Salesforce.</p>
Aptivi<p>Nitrocid service packs will get their own stable documentation.</p><p><a href="https://mastodon.social/tags/Nitrocid" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Nitrocid</span></a> <a href="https://mastodon.social/tags/NitrocidKS" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>NitrocidKS</span></a> <a href="https://mastodon.social/tags/KernelSimulator" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>KernelSimulator</span></a> <a href="https://mastodon.social/tags/TechNews" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechNews</span></a> <a href="https://mastodon.social/tags/csharp" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>csharp</span></a> <a href="https://mastodon.social/tags/programming" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>programming</span></a> <a href="https://mastodon.social/tags/dotnet" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>dotnet</span></a> <a href="https://mastodon.social/tags/docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>docs</span></a> <a href="https://mastodon.social/tags/gitbook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>gitbook</span></a></p><p><a href="https://officialaptivi.wordpress.com/2025/02/06/nitrocid-stable-documentation-will-be-split-soon/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">officialaptivi.wordpress.com/2</span><span class="invisible">025/02/06/nitrocid-stable-documentation-will-be-split-soon/</span></a></p>
Daryl the Admin 🇺🇦<p>A common question in tech writing circles is what toolset to use. As it turns out, it's not a straightforward answer.</p><p>Here's a list of 24 questions a tech writer or team can ask when trying to figure out where to start looking for the tools to use in their specific situation.</p><p><a href="https://djw.fyi/posts/choosing-a-docs-tool/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">djw.fyi/posts/choosing-a-docs-</span><span class="invisible">tool/</span></a></p><p><a href="https://vmst.io/tags/writeTheDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>writeTheDocs</span></a> <a href="https://vmst.io/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docs</span></a> <a href="https://vmst.io/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> <a href="https://vmst.io/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalWriting</span></a></p>
Miguel Afonso Caetano<p>"4. You’re not just a writer, you’re an advocate for clarity</p><p>I thought being a technical writer meant simply explaining what someone else built. But it’s so much more than that. You’re there to simplify complexity, anticipate user needs, and advocate for clarity.</p><p>Why it’s key: A good writer doesn’t just document systems, they improve them. In most cases, you should be the first real user of a new feature. Your fresh perspective can highlight gaps and improve the overall experience."</p><p><a href="https://bufferbuffer.com/10-things-i-learned-the-hard-way-about-technical-writing-in-tech/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">bufferbuffer.com/10-things-i-l</span><span class="invisible">earned-the-hard-way-about-technical-writing-in-tech/</span></a></p><p><a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalWriting</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SoftwareDocumentation</span></a> <a href="https://tldr.nettime.org/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Documentation</span></a> <a href="https://tldr.nettime.org/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docs</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SoftwareDevelopment</span></a></p>
Einstein^Vaderbilt<p>On Mobile Phone Security<br><a href="https://www.kicksecure.com/wiki/Mobile_Phone_Security" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://www.</span><span class="ellipsis">kicksecure.com/wiki/Mobile_Pho</span><span class="invisible">ne_Security</span></a><br><a href="https://defcon.social/tags/SS7" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SS7</span></a> and <a href="https://defcon.social/tags/baseband" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>baseband</span></a> <a href="https://defcon.social/tags/vulnerabilities" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>vulnerabilities</span></a> </p><p>What about <a href="https://defcon.social/tags/mobian" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mobian</span></a> hardening on a <a href="https://defcon.social/tags/MechaComet" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>MechaComet</span></a> with a cellular hat? Then there's only carrier protocol weaknesses... </p><p>If ISPs use microwave relays (the hated 'air' - remember Max Headroom) and NSA access points, is domestic broadband really secure either? But the cable or fiber doesn't have 'carrier' vulns.<br><a href="https://www.kicksecure.com/wiki/Router_and_Local_Area_Network_Security" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://www.</span><span class="ellipsis">kicksecure.com/wiki/Router_and</span><span class="invisible">_Local_Area_Network_Security</span></a></p><p><a href="https://defcon.social/tags/kicksecure" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>kicksecure</span></a> <a href="https://defcon.social/tags/whonix" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>whonix</span></a> <a href="https://defcon.social/tags/docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>docs</span></a> <a href="https://defcon.social/tags/security" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>security</span></a>-misc</p>
Miguel Afonso Caetano<p>"Asking me what’s my favourite documentation is a bit like asking me what are the best doorways I’ve crossed in my life. We remember places, not open doors; we recall the things we did through software, not great docs. In my case, I seldom remember good or great documentation because its purpose is not to get in the way. On the other hand, I do remember lots of bad documentation when it failed to provide answers. The curse of technical writing is that the best expressions of our work are the ones people rarely notice, because they offer so little friction they never disturb the user’s flow.</p><p>There are exceptions to this, of course. The first is documentation that is presented in such a way that it generates a “Wow” moment. Perhaps it’s a code snippet you can run, an interactive demo, or similar gimmicks. While they’re not key to great documentation, they make for some memorable experiences, though that can backfire quickly if the docs aren’t good. The other exception are docs that teach us something new, either through conceptual explanations or examples. Some of the best docs I’ve read are aware that they’re also teaching new ideas and concepts. You can tell because they grin."</p><p><a href="https://passo.uno/my-favorite-tech-docs/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">passo.uno/my-favorite-tech-doc</span><span class="invisible">s/</span></a></p><p><a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalWriting</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SoftwareDocumentation</span></a> <a href="https://tldr.nettime.org/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docs</span></a> <a href="https://tldr.nettime.org/tags/DocsAsCode" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>DocsAsCode</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SoftwareDevelopment</span></a></p>
Miguel Afonso Caetano<p>"In short, APIs are how businesses speak to one another. Breaking this oath with a poor integration experience is a surefire way to reduce your business potential. By utilizing a source of truth and baking a specification-first approach into your API development and documentation practices, you more clearly communicate changes, reducing the possibility of broken clients and promoting forward compatibility. Great API products must be well-described, easy to understand, and predictable in the long run.</p><p>In the end, the business effects of specification-driven development are manifold. Whether you're building RESTful, GraphQL, or event-driven partner services, having reliable API documentation is important to compete in the digital economy. This consistency equates to a better partner experience, leading to stickier partners and less customer churn. By enabling smoother integrations and reducing frustration, spec-first documentation directly contributes to partner retention and loyalty, which ultimately drives revenue growth."</p><p><a href="https://bump.sh/blog/how-spec-first-api-documentation-aids-partner-integration" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">bump.sh/blog/how-spec-first-ap</span><span class="invisible">i-documentation-aids-partner-integration</span></a></p><p><a href="https://tldr.nettime.org/tags/APIs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>APIs</span></a> <a href="https://tldr.nettime.org/tags/APIDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>APIDocumentation</span></a> <a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechnicalWriting</span></a> <a href="https://tldr.nettime.org/tags/SpecFirst" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SpecFirst</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>SoftwareDocumentation</span></a> <a href="https://tldr.nettime.org/tags/Docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docs</span></a> <a href="https://tldr.nettime.org/tags/DeveloperExperience" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>DeveloperExperience</span></a> <a href="https://tldr.nettime.org/tags/DocsAsCode" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>DocsAsCode</span></a></p>