2025-12-03 09:30:08
When #Documentation Lies: Detecting Drift Between Code and Reality
https://hackernoon.com/when-documentation-lies-detecting-drift-between-code-and-real…
When #Documentation Lies: Detecting Drift Between Code and Reality
https://hackernoon.com/when-documentation-lies-detecting-drift-between-code-and-real…
The most frustrating part of contributing to software #documentation is when the reviewer does not understand the improvement and asks for elaboration a dozen times and you keep explaining it over and over again. 🧘
And then states that they are lacking resources for reviews, but still find the time to meticulously explain how they do not see a benefit and thus hold back.
For shell examples in documents such as the FreeBSD Handbook:
― the copy icon is bugged.
It wrongly includes the command prompt.
#FreeBSD #documentation
{annotater}: Annotate package load calls, so we can have an idea of the overall purpose of the libraries we’re loading: #rstats
Happy to contribute to #Cilium (#documentation).
Good tools deserve good docs. ✨
https://github.com/cilium/cilium/pull/
Found this unnecessary (but I'm sure unintentional) gendering in W3C's TDMRep docs repo:
Submitted an issue: 🤞
#W3C #documentation #GitHub #gendering #technology #equality #fairness