mastodon.world is one of the many independent Mastodon servers you can use to participate in the fediverse.
Generic Mastodon server for anyone to use.

Server stats:

9.6K
active users

#documentation

14 posts14 participants0 posts today
Gator3000 ⏚<p>🎉 <a href="https://mastodon.social/tags/Masthon" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Masthon</span></a> 0.1.1 alpha is now up ! :catjam: </p><p>Masthon is a package that links your programs to the mastodon <a href="https://mastodon.social/tags/API" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>API</span></a> </p><p>The version 0.1.1 alpha is published on <a href="https://mastodon.social/tags/gitlab" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>gitlab</span></a> : Come on and review, see my <a href="https://mastodon.social/tags/code" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>code</span></a> at <a href="https://gitlab.com/Gator3000/masthon/-/releases" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">gitlab.com/Gator3000/masthon/-</span><span class="invisible">/releases</span></a>.</p><p>You can install the package with <a href="https://mastodon.social/tags/pip" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>pip</span></a> :<br>```<br>pip install git+<a href="https://gitlab.com/Gator3000/masthon.git" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">gitlab.com/Gator3000/masthon.g</span><span class="invisible">it</span></a><br>```<br>The <a href="https://mastodon.social/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> will be available tomorrow when the beta will be published.</p><p>If you want information or to <a href="https://mastodon.social/tags/contribute" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>contribute</span></a> tell me on this account.</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/mastodonapi" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mastodonapi</span></a> <a href="https://mastodon.social/tags/opensource" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>opensource</span></a></p>
Winter Rant<p><strong>The Weekly: No Vibes in Manuals and&nbsp;Testing</strong></p><p><em>… also in this issue: <a href="https://rant.vpalepu.com/2025/04/28/the-weekly-no-vibes-in-manuals-and-testing#life-is-for-living" rel="nofollow noopener noreferrer" target="_blank">Sauce, SloMo</a> and some <a href="https://rant.vpalepu.com/2025/04/28/the-weekly-no-vibes-in-manuals-and-testing/#on-my-mind" rel="nofollow noopener noreferrer" target="_blank">stuff brewing in my mind</a>.</em></p><p>There is a scene in Die Another Day, where Q hands Bond a thick instruction manual for his new Aston Martin that comes with all kinds of guns and gadgets, and says, <em>“You should be able to shoot through that in a couple of hours.”</em> </p><p>Bond takes the manual tosses it in the air and the car’s motion-detecting machine guns fire the manual to bits. Bond then remarks, <em>“Just took a few seconds, Q!”</em></p><a href="https://youtu.be/ICmuFRBvPmk?si=Kg8ONqtdubMBlgul&amp;t=85" rel="nofollow noopener noreferrer" target="_blank"></a><p>It’s a telling scene that betrayed a broader cultural attitude towards instruction manuals: no one likes instruction manuals. I grew up in a generation that tossed aside instruction manuals and instead just drove the machine, be it a car or a software application.</p><p>Manuals and handbooks were commonplace in the case of software for the longest time. But at some point people just stopped reading them. <em>Learn by doing</em> became the mantra around software. Running the program or software application first, to learn what it could (or could not) do, was the way to go. We all wanted to discover the application’s features ourselves without having to read through reams of text. Playing (or tinkering) with the app, especially for newly released software, came with a sense instant gratification.</p><p>Not sure when it happened but, slowly but surely the vibes around software manuals just vanished. Even if they came with the boxed software, or CD-ROM, people would typically just toss them aside. Of course, some folks would read them I suppose. IT Admins who manage enterprise software come to mind… as cohort of people reading these things; but that was because they were paid to do so. If you did not think that there was a need or requirement to read manuals, you skipped it.</p><p>It’s not like people got better at discovering features in software applications. On the contrary, I think tossing away the software manual created a new problem for software developers: feature discovery.</p><p>It is common to hear a software application’s end-users complain about missing features, while not realizing that the feature is already available and simply requires turning on a setting or configuration. Not discovering such settings in complex software applications became a direct consequence of software manuals falling out of fashion1. Collectively, humanity set aside a useful artifact for only one tiny benefit — we did not have to spend time reading. The practice of not reading manuals was a net loss. </p><p>Software Writer was a whole job category that just went out of fashion with those manuals. You see, writing anything, even software manuals, needs expertise and skill. But when you stop shipping those manuals, you do not need folks who possess such skills.</p><p>In fact, it gave rise to a subtler, invisible problem: software developers stopped documenting their code. If your users are not interested in manuals for the app’s features, then what’s the point in writing down notes about how the app works? Over time this became an anti-pattern that developer community recognized, and course corrected on. As an industry, I would argue that we have slowly come to recognize the value of maintaining documentation for software projects, esp. as wikis and open source software gained momentum. But still … do not expect anything but dirty looks when you ask a programmer to document their code. Writing is sadly not a dominant part of software culture at this point.</p><p><strong>I worry about another artifact losing its vibes much in the same way that manuals did: software tests.</strong></p><p>Software tests suffer from the same disdain that software manuals and documents do. You do not ship software tests to the end-user, so why bother writing and maintaining them? It’s not like we have figured out a better way to enforce software quality. Programmers are still shipping software with bugs. But just as with software manuals, we do not have good substitutes for software tests — we just rather not write them. And just like with job roles like Software Writer, roles around software testing is a dying job category. Startups and larger enterprises alike, question the value of a software tester.</p><p>Like with Software Writer, turns out that being a Software Tester requires skill and expertise. Writing test code is a fundamentally different skill than writing application code. I have seen some skilled programmers who are just plain <s>bad</s> <s>terrible</s> atrocious at writing software tests. They have the capability to stink up a whole room with their software tests2.</p><p>And like all things, AI is pouring gasoline on these problems. It’s a problem that predates AI, so I do not place primary blame on AI. That said, developers of all stripes are ready to generate documentation and tests without really caring if any of it is correct. We are setting fire to real value when it comes to software manuals and tests. I wish we could ship those artifacts to end users in a way that genuinely engages software users. It is a real problem.</p> <p><strong>Life is for Living: SloMo and Sauce</strong></p><p><em>Instead of rushing through life, I find myself standing still more than I used to. It has allowed me to notice life around me. And when not intensely private, I capture it with my camera.</em></p><p><strong>Pasta Sauce</strong></p><p>This weekend, I spent some time cooking. One thing I ended up making was a pasta sauce with tomatoes, garlic, basil, rosemary and thyme, lots of black pepper and salt. The wife loved it, thank goodness! Here is a snapshot of the ingredients just out of the oven, baked … right before I blended them.</p><p></p><p><strong>Water Dropping in SloMo</strong></p><p>I walk past this fountain ⛲️ almost every day. I like sitting next to it every so often. Recently I captured the water droplets in slow motion. The result turned out to be a satisfying ASMR video. <a href="https://vimeo.com/1079636451" rel="nofollow noopener noreferrer" target="_blank">Check it out…</a></p><p><a href="https://vimeo.com/1079636451" rel="nofollow noopener noreferrer" target="_blank">https://vimeo.com/1079636451</a></p><p></p> <p><strong>On my mind: anything but AI</strong></p><p>I realized that anything I think about lately is tainted by AI. Anything I want to write about has a profound AI-angle to it. I get that AI is everywhere. But not everything needs to be about AI. AI this, AI that. It started to become nauseating. I also found it to be intellectually lazy.</p><p>So, I took a break from writing and blogging last week and started thinking hard about things that are not principally about artificial intelligence. In fact, I am obsessed — both at work and in personal life — on how to best approach an issue without AI in the mix.</p><p>Don’t get me wrong: I think there are really cool applications of AI that I use everyday. But the best way to discover those cool applications of AI is to think hard about how to first approach something without AI. And I suspect that it is also a great way to<strong> keep the human in the loop at all times. </strong></p><p>It is a healthy exercise for me, mentally and intellectually. You will see me write more about things where AI is not the main character. I will still have my AI-rants and takes. But they will start featuring less over time.</p> <p><strong>footnotes</strong></p><ol><li>I have no data to back this of course. That is why this remains a blog called “Winter Rant” and not an academic publication 😁 ↩︎</li><li>I could write dissertations on this subject. ↩︎</li></ol><p><a rel="nofollow noopener noreferrer" class="hashtag u-tag u-category" href="https://rant.vpalepu.com/tag/cooking/" target="_blank">#Cooking</a> <a rel="nofollow noopener noreferrer" class="hashtag u-tag u-category" href="https://rant.vpalepu.com/tag/documentation/" target="_blank">#Documentation</a> <a rel="nofollow noopener noreferrer" class="hashtag u-tag u-category" href="https://rant.vpalepu.com/tag/james-bond/" target="_blank">#JamesBond</a> <a rel="nofollow noopener noreferrer" class="hashtag u-tag u-category" href="https://rant.vpalepu.com/tag/manuals/" target="_blank">#Manuals</a> <a rel="nofollow noopener noreferrer" class="hashtag u-tag u-category" href="https://rant.vpalepu.com/tag/slomo/" target="_blank">#SloMo</a> <a rel="nofollow noopener noreferrer" class="hashtag u-tag u-category" href="https://rant.vpalepu.com/tag/software-manuals/" target="_blank">#SoftwareManuals</a> <a rel="nofollow noopener noreferrer" class="hashtag u-tag u-category" href="https://rant.vpalepu.com/tag/software-tester/" target="_blank">#SoftwareTester</a> <a rel="nofollow noopener noreferrer" class="hashtag u-tag u-category" href="https://rant.vpalepu.com/tag/software-testing/" target="_blank">#SoftwareTesting</a> <a rel="nofollow noopener noreferrer" class="hashtag u-tag u-category" href="https://rant.vpalepu.com/tag/software-writer/" target="_blank">#SoftwareWriter</a> <a rel="nofollow noopener noreferrer" class="hashtag u-tag u-category" href="https://rant.vpalepu.com/tag/testing/" target="_blank">#Testing</a></p>
2rZiKKbOU3nTafniR2qMMSE0gwZHow to Write Effective Cybersecurity Documentation and Pentest Reports Whether you’re performin...<br><br><a href="https://diog0net0sec.medium.com/how-to-write-effective-cybersecurity-documentation-and-pentest-reports-4b0fe326db11?source=rss------documentation-5" rel="nofollow noopener noreferrer" target="_blank">https://diog0net0sec.medium.com/how-to-write-effective-cybersecurity-documentation-and-pentest-reports-4b0fe326db11?source=rss------documentation-5</a><br><br><a rel="nofollow noopener noreferrer" class="mention hashtag" href="https://mastodon.social/tags/cybersecurity" target="_blank">#cybersecurity</a> <a rel="nofollow noopener noreferrer" class="mention hashtag" href="https://mastodon.social/tags/tools" target="_blank">#tools</a> <a rel="nofollow noopener noreferrer" class="mention hashtag" href="https://mastodon.social/tags/documentation" target="_blank">#documentation</a> <a rel="nofollow noopener noreferrer" class="mention hashtag" href="https://mastodon.social/tags/reporting" target="_blank">#reporting</a> <a rel="nofollow noopener noreferrer" class="mention hashtag" href="https://mastodon.social/tags/pentest" target="_blank">#pentest</a><br><br><a href="https://awakari.com/pub-msg.html?id=9IoJe1yPnIqIu6AQB9UEeGLzWXQ&amp;interestId=2rZiKKbOU3nTafniR2qMMSE0gwZ" rel="nofollow noopener noreferrer" target="_blank">Result Details</a>
Jon Seager<p>A nice post from Christian Ehrhardt, Engineering Director for <a href="https://hachyderm.io/tags/Ubuntu" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Ubuntu</span></a> Server outlining how the <a href="https://hachyderm.io/tags/Canonical" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Canonical</span></a> Open Documentation Academy has helped with the Ubuntu Server <a href="https://hachyderm.io/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> </p><p>Check out the post: <a href="https://discourse.ubuntu.com/t/60012" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">discourse.ubuntu.com/t/60012</span><span class="invisible"></span></a></p><p>And the Open Documentation Academy: <a href="https://canonical.com/documentation/open-documentation-academy" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">canonical.com/documentation/op</span><span class="invisible">en-documentation-academy</span></a></p>
tjhowse<p>Wow! What a great idea!</p><p>I often check the publication date of an article to work out whether the information is A) Hopelessly out of date, or B) "Written" after the slopocalypse.</p><p>This neat header acknowledges a limitation of the article. Good stuff.</p><p><a href="https://aaronsaray.com/2021/ansible-reboot-if-required/" rel="nofollow noopener noreferrer" target="_blank"><span class="invisible">https://</span><span class="ellipsis">aaronsaray.com/2021/ansible-re</span><span class="invisible">boot-if-required/</span></a></p><p><a href="https://howse.social/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> <a href="https://howse.social/tags/swdev" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>swdev</span></a> <a href="https://howse.social/tags/ansible" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>ansible</span></a></p>
Vassil Nikolov<p>If you post a program (library, module, whatever) and don't have a summary with a _specific_ description, you could copy and paste the first line of the doc-string of the main function (or equivalent).</p><p>If it is not worth your time documenting (properly) what you post, it is unlikely that it will be worth anybody's time reading it.</p><p><a href="https://ieji.de/tags/CommonLisp" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>CommonLisp</span></a><br><a href="https://ieji.de/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Documentation</span></a></p>
Frontend Dogma<p>Teaching Code in the AI Era: Why Fundamentals Still Matter, by @alispit.tel:</p><p><a href="https://dev.to/aspittel/teaching-code-in-the-ai-era-why-fundamentals-still-matter-1k1g" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">dev.to/aspittel/teaching-code-</span><span class="invisible">in-the-ai-era-why-fundamentals-still-matter-1k1g</span></a></p><p><a href="https://mas.to/tags/training" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>training</span></a> <a href="https://mas.to/tags/ai" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>ai</span></a> <a href="https://mas.to/tags/programming" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>programming</span></a> <a href="https://mas.to/tags/vibecoding" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>vibecoding</span></a> <a href="https://mas.to/tags/security" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>security</span></a> <a href="https://mas.to/tags/scalability" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>scalability</span></a> <a href="https://mas.to/tags/performance" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>performance</span></a> <a href="https://mas.to/tags/quality" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>quality</span></a> <a href="https://mas.to/tags/testing" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>testing</span></a> <a href="https://mas.to/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a></p>
2rZiKKbOU3nTafniR2qMMSE0gwZCybersecurity Audit Vault In this post, we’ll shift the focus away from the usual pentesting te...<br><br><a href="https://meravytes.medium.com/cybersecurity-audit-vault-49d14dc0ea56?source=rss------documentation-5" rel="nofollow noopener noreferrer" target="_blank">https://meravytes.medium.com/cybersecurity-audit-vault-49d14dc0ea56?source=rss------documentation-5</a><br><br><a rel="nofollow noopener noreferrer" class="mention hashtag" href="https://mastodon.social/tags/cybersecurity" target="_blank">#cybersecurity</a> <a rel="nofollow noopener noreferrer" class="mention hashtag" href="https://mastodon.social/tags/documentation" target="_blank">#documentation</a> <a rel="nofollow noopener noreferrer" class="mention hashtag" href="https://mastodon.social/tags/information-security" target="_blank">#information-security</a> <a rel="nofollow noopener noreferrer" class="mention hashtag" href="https://mastodon.social/tags/audit" target="_blank">#audit</a> <a rel="nofollow noopener noreferrer" class="mention hashtag" href="https://mastodon.social/tags/meravytes" target="_blank">#meravytes</a><br><br><a href="https://awakari.com/pub-msg.html?id=0VbIz0iW7uV1OHwuJBq8bRTqsbY&amp;interestId=2rZiKKbOU3nTafniR2qMMSE0gwZ" rel="nofollow noopener noreferrer" target="_blank">Result Details</a>
Registrar Trek<p>This is a follow-up of the more generalized post <br>Let's Talk About Data Security - Backups<br><a href="https://world.museumsprojekte.de/lets-talk-about-data-security-backups/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">world.museumsprojekte.de/lets-</span><span class="invisible">talk-about-data-security-backups/</span></a> </p><p><a href="https://glammr.us/tags/museum" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>museum</span></a> <a href="https://glammr.us/tags/museums" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>museums</span></a> <a href="https://glammr.us/tags/databases" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>databases</span></a> <a href="https://glammr.us/tags/data" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>data</span></a> <a href="https://glammr.us/tags/MuseumDocumentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>MuseumDocumentation</span></a> <a href="https://glammr.us/tags/DataSecurityIsCollectionsManagement" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>DataSecurityIsCollectionsManagement</span></a> <a href="https://glammr.us/tags/CollectionsManagement" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>CollectionsManagement</span></a> <a href="https://glammr.us/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Documentation</span></a> <a href="https://glammr.us/tags/RegistrarLife" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>RegistrarLife</span></a></p>
Alvin Ashcraft 🐿️<p>Pocket Flow Tutorial/Sample - Turns a Codebase into a Tutorial with AI.</p><p><a href="https://github.com/The-Pocket/Tutorial-Codebase-Knowledge" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/The-Pocket/Tutorial</span><span class="invisible">-Codebase-Knowledge</span></a> </p><p><a href="https://hachyderm.io/tags/oss" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>oss</span></a> <a href="https://hachyderm.io/tags/ai" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>ai</span></a> <a href="https://hachyderm.io/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> <a href="https://hachyderm.io/tags/docs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>docs</span></a></p>
Bob Carver<p>Threat Actors Don’t Care About Your Compliance Score<br><a href="https://youtu.be/mYsSUR6z6BA" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">youtu.be/mYsSUR6z6BA</span><span class="invisible"></span></a> . <a href="https://infosec.exchange/tags/cybersecurity" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>cybersecurity</span></a> <a href="https://infosec.exchange/tags/GRC" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GRC</span></a> <a href="https://infosec.exchange/tags/audits" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>audits</span></a> <a href="https://infosec.exchange/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> <a href="https://infosec.exchange/tags/threatactors" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>threatactors</span></a> <a href="https://infosec.exchange/tags/vulnerabilities" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>vulnerabilities</span></a> <a href="https://infosec.exchange/tags/threathunting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>threathunting</span></a> <a href="https://infosec.exchange/tags/riskmanagent" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>riskmanagent</span></a> <a href="https://infosec.exchange/tags/compliance" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>compliance</span></a> <a href="https://infosec.exchange/tags/NIST" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>NIST</span></a> <a href="https://infosec.exchange/tags/CMMC" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>CMMC</span></a></p>
Pol Dellaiera<p>You can now enjoy the full Nixpkgs manual with all Nix code blocks automatically formatted using the default formatter:</p><p>🔗 <a href="https://nixos.org/manual/nixpkgs/unstable/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">nixos.org/manual/nixpkgs/unsta</span><span class="invisible">ble/</span></a></p><p>This was made in <a href="https://github.com/NixOS/nixpkgs/pull/397142" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/NixOS/nixpkgs/pull/</span><span class="invisible">397142</span></a>, thanks to *Markdown Code Runner*, my very first Rust CLI application:</p><p>🔗 <a href="https://github.com/drupol/markdown-code-runner" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/drupol/markdown-cod</span><span class="invisible">e-runner</span></a></p><p><a href="https://mathstodon.xyz/tags/Nix" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Nix</span></a> <a href="https://mathstodon.xyz/tags/NixOS" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>NixOS</span></a> <a href="https://mathstodon.xyz/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Documentation</span></a></p>
XWiki SAS<p>🎮 It's Friday! Time for a quick knowledge management game...<br>Wishing everyone a fantastic weekend full of relaxation and zero frantic document searches!</p><p>Fill in the blank: "I spent __ hours this week searching for documents that should have taken me 5 minutes to find."<br><a href="https://fosstodon.org/tags/poll" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>poll</span></a> <a href="https://fosstodon.org/tags/what" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>what</span></a> <a href="https://fosstodon.org/tags/OpenSource" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OpenSource</span></a> <a href="https://fosstodon.org/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Documentation</span></a> <a href="https://fosstodon.org/tags/efficiency" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>efficiency</span></a></p>
amen zwa, esq.<p>The lack of proper <a href="https://mathstodon.xyz/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> on most open-source and almost all proprietary <a href="https://mathstodon.xyz/tags/software" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>software</span></a> development projects in <a href="https://mathstodon.xyz/tags/IT" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>IT</span></a> is downright alarming. This trend picked up pace around 2010s.</p><p>Some projects simply auto-generate the so-called documentation. Well, that is not documentation; in fact, I'd rather read the undocumented code, instead. And even those projects that chose to document, and some do quite well, only publish online versions that, when exported to PDF look grotesque, due to the gratuitous use of fancy HTML, CSS, and JavaScript tricks. It's a documentation, not an application! That is a waste of effort, not to mention a cruel joke upon those who prefer to read a PDF, offline.</p><p>Documentation need not be burdensome, nor need it be aflush with details that will surely go out of date in a few days. That age-old argument—"Well, we don't write documentation, because it doesn't evolve with fast-changing code"—is but a feeble excuse. The documentation that simply repeats what the code clearly communicates is useless, nay, harmful.</p><p>At the very least, the team should write down the key business drivers, the major technical factors, the core design choices, and a short manual to spin up new team members, quickly.</p><p>This last document is perhaps the most important one. And I'm not talking about "how to get the source code", "how to install the tools", or similarly childish stuff. I'm talking about a brief that quickly orients new staff to the team's purpose.</p><p>Today in the industry, there is much deliberate hazing of new teammates. The culture now is RTFC—the "C" being the "undocumented, uncommented, buggy, old, rotting code that no one fully understands anymore".🤦‍♂️</p>
Inautilo<p><a href="https://mastodon.social/tags/Design" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Design</span></a> <a href="https://mastodon.social/tags/Collections" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Collections</span></a><br>Design System Tactics · Tactics to help you make progress at every stage <a href="https://ilo.im/163g01" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">ilo.im/163g01</span><span class="invisible"></span></a></p><p>_____<br><a href="https://mastodon.social/tags/DesignSystems" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>DesignSystems</span></a> <a href="https://mastodon.social/tags/Strategy" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Strategy</span></a> <a href="https://mastodon.social/tags/Metrics" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Metrics</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/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Documentation</span></a> <a href="https://mastodon.social/tags/DesignProcess" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>DesignProcess</span></a> <a href="https://mastodon.social/tags/ProductDesign" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>ProductDesign</span></a> <a href="https://mastodon.social/tags/UxDesign" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>UxDesign</span></a> <a href="https://mastodon.social/tags/UiDesign" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>UiDesign</span></a> <a href="https://mastodon.social/tags/WebDesign" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>WebDesign</span></a></p>
Marcel Wiessler<p>The Needle Engine <a href="https://mastodon.gamedev.place/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> is now available in multiple languages:</p><p>Chinese<br>Spanish<br>Portugese<br>French<br>Hindi<br>Japanese<br>Vietnamese <br>and German!</p><p>Docs: <a href="https://engine.needle.tools/docs/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">engine.needle.tools/docs/</span><span class="invisible"></span></a></p><p><a href="https://mastodon.gamedev.place/tags/needle" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>needle</span></a> <a href="https://mastodon.gamedev.place/tags/threejs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>threejs</span></a> <a href="https://mastodon.gamedev.place/tags/webdev" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>webdev</span></a> <a href="https://mastodon.gamedev.place/tags/ai" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>ai</span></a></p>
Linux Is Best<p><span>Re-written to be a little clearer, less wordy in some places.<br><br>I think this one works nicely.</span></p><blockquote><span>NixOS is an operating system. An operating system is the main software that lets you use your computer through a user interface. Examples include Microsoft Windows, Apple macOS, Linux, and BSD.<br><br>NixOS is a Linux-based operating system. Like Windows or macOS, NixOS can have an easy-to-use graphical user interface (GUI). A popular GUI for Linux is called KDE Plasma — it offers a simple, point-and-click environment similar to Windows or macOS. It includes a control panel (called Settings) where you can manage most of your commonly used options.<br><br>But for more advanced settings, NixOS is different from most Linux-based operating systems. In fact, it can be easier to use because NixOS relies on one master file to configure nearly everything. This simplifies things, while common settings are still conveniently controlled through KDE Plasma, as mentioned earlier.<br><br>The master configuration file is located at: /etc/nixos/configuration.nix<br><br>For former macOS users, this file path should be familiar. But for those coming from Microsoft Windows, it might be a bit different. In Windows, a file path would look like this:<br><br>C: \ etc \ nixos \ configuration.nix<br><br>In contrast, Linux (like macOS and BSD) uses a file path structure like:<br><br>/ etc / nixos / configuration.nix<br><br>This means you don't use a drive letter, and instead of a backslash \ you use a forward slash /<br><br>Fun fact: Microsoft Windows is the only mainstream operating system that hasn't fully adopted this universal directory path structure. Even mobile devices like Apple iOS and Android use this format under the hood.<br><br>In Microsoft Windows, you use File Explorer to navigate your folders. In Apple macOS, you use Finder. In NixOS with KDE Plasma, you use Dolphin.<br><br>Additionally, what sets NixOS apart from many other Linux distributions is that it is immutable. This means the root system is protected and can be easily recovered. If something goes wrong, you can simply reboot and select a previous save. It's similar to restoring a saved game with a timestamp from the boot menu. This feature makes NixOS more secure, stable, and easier to recover from problems.</span></blockquote><a href="https://mk.absturztau.be/tags/NixOS" rel="nofollow noopener noreferrer" target="_blank">#NixOS</a> <a href="https://mk.absturztau.be/tags/Nix" rel="nofollow noopener noreferrer" target="_blank">#Nix</a> <a href="https://mk.absturztau.be/tags/Linux" rel="nofollow noopener noreferrer" target="_blank">#Linux</a> <a href="https://mk.absturztau.be/tags/Windows" rel="nofollow noopener noreferrer" target="_blank">#Windows</a> <a href="https://mk.absturztau.be/tags/Documentation" rel="nofollow noopener noreferrer" target="_blank">#Documentation</a><p></p>
Inautilo<p><a href="https://mastodon.social/tags/Development" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Development</span></a> <a href="https://mastodon.social/tags/Launches" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Launches</span></a><br>Sandboxes · A repository of 30+ playgrounds for developers <a href="https://ilo.im/163fl8" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">ilo.im/163fl8</span><span class="invisible"></span></a></p><p>_____<br><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/Coding" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Coding</span></a> <a href="https://mastodon.social/tags/Playgrounds" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Playgrounds</span></a> <a href="https://mastodon.social/tags/Blog" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Blog</span></a> <a href="https://mastodon.social/tags/Documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Documentation</span></a> <a href="https://mastodon.social/tags/Education" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Education</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/WebDev" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>WebDev</span></a> <a href="https://mastodon.social/tags/Frontend" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Frontend</span></a> <a href="https://mastodon.social/tags/Backend" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Backend</span></a></p>
Linux Is Best<p><span>Trying to make this "stupid, smart". <br><br>Or, to put it another way, trying to word this in away that a dumb people knowing nothing, can understand this, and feel smart once they have read it. But while trying to keep it really simple, without being overwhelming.</span></p><blockquote><span>NixOS is an operating system, and an operating system is the software user interface that allows you to use your computer. An example would be, Microsoft Windows, Apple macOS, Linux, and BSD. <br><br>NixOS particularly is a Linux-based operating system. NixOS, like Microsoft Windows or Apple macOS, can offer an easy-to-use, graphic user interface (GUI). A common and popular GUI for Linux is called, KDE Plasma. KDE Plasma, offers a very easy-to-use, point and click, environment, similar to Windows or Apple, but not identical, including a control panel (called, Settings), for most of your commonly used settings.<br><br>But for the more in-depth settings, NixOS is not like most Linux-based operating systems. In fact, it can be easier to use because, NixOS uses 1 master file to configure nearly everything, except for the previously mentioned common settings which are still conveniently controlled in KDE Plasma.<br><br>This master configuration file is located at: /etc/nixos/configuration.nix<br><br>For previous Apple macOS users, this file path will be easy to understand. But for those of you coming from Microsoft Windows, unlike, Microsoft Windows, which file path would have been: <br><br>C:\etc\nixos\configuration.nix<br><br>Linux, like macOS and BSD use<br><br>/etc/nixos/configuration.nix<br><br>Meaning, you do not use a drive letter, and instead of a backlash \ you use a forward slash /<br><br>Fun fact: Microsoft Windows, is the only mainstream operating system, which has not yet adapted this universal standard, and under the hood, even mobile devices such as Apple iOS and Android, use this directory path structure.<br><br>Additionally, what separates NixOS from many other Linux developments is it an immutable Linux distribution (distro). Meaning, the root system is protected and also recoverable, meaning if something were to go wrong, you can reboot and select the previous save. This makes NixOS more secure, stable, and easier to recover if anything were to go wrong.</span></blockquote><a href="https://mk.absturztau.be/tags/NixOs" rel="nofollow noopener noreferrer" target="_blank">#NixOs</a> <a href="https://mk.absturztau.be/tags/Nix" rel="nofollow noopener noreferrer" target="_blank">#Nix</a> <a href="https://mk.absturztau.be/tags/Linux" rel="nofollow noopener noreferrer" target="_blank">#Linux</a> <a href="https://mk.absturztau.be/tags/Windows" rel="nofollow noopener noreferrer" target="_blank">#Windows</a> <a href="https://mk.absturztau.be/tags/Documentation" rel="nofollow noopener noreferrer" target="_blank">#Documentation</a><p></p>
katzenberger<p>"So that we won't say we didn't know"</p><p>A <a href="https://tldr.nettime.org/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> project by citizens of <a href="https://tldr.nettime.org/tags/Israel" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Israel</span></a> that proves you <u>can</u> know what is going on in <a href="https://tldr.nettime.org/tags/Gaza" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Gaza</span></a> and the <a href="https://tldr.nettime.org/tags/WestBank" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>WestBank</span></a>, if you care to not close your eyes.</p><p>»The Daily File is an independent voluntary project by Israeli citizens wishing to bring attention to numeric, visual, documentary information about the daily goings-on in the West Bank and in the Gaza Strip, the interface of <a href="https://tldr.nettime.org/tags/Palestinians" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Palestinians</span></a> and the Israeli security forces and colonists.«</p><p><strong>CW / Content warning:</strong></p><p>The linked website also documents photography and videos showing what is happening, including wounded human beings and corpses of all ages.</p><p><a href="https://www.thedailyfile.org/blog/categories/gaza" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://www.</span><span class="ellipsis">thedailyfile.org/blog/categori</span><span class="invisible">es/gaza</span></a> </p><p><a href="https://tldr.nettime.org/tags/DailyFile" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>DailyFile</span></a></p>