this post was submitted on 15 Aug 2023
575 points (95.9% liked)
Linus Tech Tips
3784 readers
1 users here now
~~⚠️ De-clickbait-ify the youtube titles or your post will be removed!~~
~~Floatplane titles are perfectly fine.~~
~~LTT/LMG community. Brought to you by ******... Actually, no, not this time. This time it's brought to you by Lemmy, the open communities and free and open source software!~~
~~If you post videos from Youtube/LTT, please please un-clickbait the titles. (You can use the title from https://nitter.net/LTTtranslator/ but it doesn't seem to have been updated in quite some while...)~~
founded 1 year ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
I understand. I have been tasked, at times, with writing fairly simple documents to guide co-workers to complete a task; bearing in mind that my coworkers, for all intents and purposes, are very smart, experienced, and otherwise knowledgeable people doing the same job I am (more or less). Most technical jobs essentially require, as an unwritten rule, a certain level on improvisation, and the ability to extrapolate information from an incomplete dataset.
However, I generally need to run through the process 2 or 3 times before I can complete the task of writing the docs for it, the first time, I go through and mostly figure it out, make some general notes on what I'm doing, so I can repeat the process myself.... The second time, I'm generally collecting screen shots, and filling in any blanks in the process I may have glossed over in my notes from the first pass, then before I'm "ready to go to print" I'm re-reviewing the entirety of my new document in an editing mindset, rephrasing and clarifying things as best as I can; then I'll usually follow my own document to make sure that if I only do the steps listed, the process will complete successfully.
At which point, I have a draft.
I then, usually, ask my least skilled coworker to give it a once over to see if it makes sense to them, and offer any constructive criticism that they may have, with a second (revised) draft going to another low-skill coworker for final "review".
That's 2-3 people examining the material before it ships, and I've personally gone over it two or three times to check spelling, grammar, accuracy, etc.
And that's for an internal document about a process that 90% of my team can probably half-guess their way through, even if they've never touched the related thing before. It's a certain level of consistency and accuracy and I won't accept any less from myself. I want to ensure that if my document is given to a client, or Joe worker, they can complete it without issue down the line.
This is the level of integrity that I expect, both from myself and from any organization that I would trust to provide reliable information. The blunt fact is that LTT doesn't seem to be even double checking their work at all, meanwhile I'm putting myself to the standard of double checking, and ensuring my information gets peer reviewed before going to "print" (so to speak).
Granted, most of the stuff I do is generally less complex, usually guides and instructions on fairly mediocre technical topics, not full reviews of embargoed devices using pre-release firmware and drivers, but still, the methodology for the consistency of the information should be there. As GN had clearly demonstrated, it is not. And that's just regarding their technical inaccuracies. I'm not going to touch the issues surrounding transparency and decisions made at the highest levels, like the recently developed issue stemming from this regarding the handling of the prototype waterblock. For me, the most recent developments there are simply deeply disappointing, and demonstrative of the fact that they're willing to state things as fact before things become fact.