From d57e14101c9faac98962e70c7934a1e6439e7821 Mon Sep 17 00:00:00 2001 From: nat Date: Tue, 25 Mar 2025 19:31:31 -0700 Subject: [PATCH] add thought; fix figure css --- .../fuck-you-make-your-docs-public.png | Bin 0 -> 7849 bytes ...ation-accessible-without-a-fucking-account | 25 ++++++++++++++++++ style.css | 1 + 3 files changed, 26 insertions(+) create mode 100644 files/thoughts/fuck-you-make-your-docs-public.png create mode 100644 html/thoughts/make-your-documentation-accessible-without-a-fucking-account diff --git a/files/thoughts/fuck-you-make-your-docs-public.png b/files/thoughts/fuck-you-make-your-docs-public.png new file mode 100644 index 0000000000000000000000000000000000000000..cf77f15f259ceca9ec66513ede153d768b6316bd GIT binary patch literal 7849 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 + + + +

documentation is meant to be read

+do not make it harder for this one, or anyone else to read. if you do, it will hate you forever. +$[img-caption /files/thoughts/fuck-you-make-your-docs-public.png "a warning in a github readme, advising users to read the pinned post in the project discord for help with a recent issue"] +$[make-footnote "font antialiasing is disabled on its computer. the image will look bad unless at a certain size."] +

+do not make anyone ever join a discord server to read documentation. +if you can write a message about a problem in discord and pin it, you can copy that information in to a markdown document and push it to git. +it does not want to join your discord server. it does not want to join your matrix room. it does not want to join your arcane and non-publicly-indexed forum of any kind. +it wants to fix the issue it is having. +

+it is perfectly willing to join community forums in cases where it is interested in the project. this is not the issue. +the issue is someone arbitrarily deciding that—instead of simply providing one with the relevant information—that one must first solve some poorly constructed riddle made out of group invite links and login portals first, at no benefit to literally anyone. +

+it cannot understand the thought process that leads to doing this. +unfortunately, it seems to be a common one, as this one has encountered many instances of this. +it cannot fathom how utterly muffin-brained someone must be to write documentation on how to solve an issue and then deliberately obfuscate said documentation. +this makes it more annoyed than scientific articles being paywalled, because it can't even blame the capitalist greed. +publish documentation or don't write it in the first place.$[make-footnote "the particular instance pictured made it annoyed enough to write a \"thought\" for the first time in months."] +
+$[put-footnotes] + diff --git a/style.css b/style.css index d3a402f..08f7f47 100644 --- a/style.css +++ b/style.css @@ -311,6 +311,7 @@ figure { margin-bottom: 15px; > a { + width: auto; padding: 10px; padding-bottom: 0;