this post was submitted on 08 Aug 2023
1945 points (98.9% liked)
Firefox
17938 readers
2 users here now
A place to discuss the news and latest developments on the open-source browser Firefox
founded 4 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
Friend bought an Asus motherboard. In the user's manual, in the pins layout section, there's no instructions nor description of the pins, but instead a QR code and a text that tell you to scan it for the Pins Layout instructions. (Note: The page is mostly blank and have tons of empty space, beside the QR code and the little small print texts). Scan The QR code, lead to a page to download another PDF. Open the PDF, it have one single page showing the Pins Layout description. (That only took half of the page)
And my friend wonder why I got so mad.
You just know that that page will be gone one day and then nobody will ever be able to find that pinout anymore
Not to mention that nobody knows what other code that QR code might have run on their device when it was scanned.
QR codes themselves are a security problem.
QR codes just store a text string, so it's down to the client to interpret the string and execute it in a safe manner
Print the page and save it in a box so you can be a hero in 20 years.
As a public service, we should set up clearly named torrents of files like this.
This is reminding of how pissed off I am with Adobe recently after using After Effects a lot, documentation, or lack thereof. It's really hard to find instructions on what a given effect does, or how to use it. Each effect in the effect panel in After Effects itself has an about button in a context menu, but it's a credit for the author of the effect which is useless and weird anyway because aside from some exceptions the credit is 'Adobe' . There's no locally supplied electronic document for the user manual, it's all online. That's frustrating enough, but there doesn't really seem to be any one single user manual, there's lots of different things with similar names but with widely varying degrees of detail. Sometimes if you happen to accidentally stumble on to the right section of Adobe's site that has a list of effects and also details about them (there's at least one page which just lists them) the degree of detail is variable in the extreme. One effect I tried to use didn't have any user reference and the best I could find on Adobe's own website was a dead link to a forum post (not Adobe's forums, a random internet forum) which I was eventually able to find myself through Google and then recover the video via youtube (the original of course was long since not on that site). That video also, while very helpful, wasn't even entirely correct because the author of the effect responded to the forum post many years ago to correct some incorrect information in the tutorial.
I was already furious at this fucking joke of an attempt at documentation of their own software, but I looked up more videos, all from around 2008-2009ish and in those videos, the user was running the Adobe Creative Suite software that used to come in a box before Creative Cloud and they were able to open up a real user manual that came with the software which had documentation for the very effect that they were able to browse to demonstrate some of the concepts for its proper use. WTF!? They had documentation already written and then revoked access to it! Why!? What's the point? Ant they have the documentation for the effects in some form albeit varyingly useful, on their website, why can't they just collate it in to a PDF and package with the application download? Resolve does, I use it often. It's so unprofessional to rely on random internet forum posts from decades past in lieu of proper documentation. People lament users not RTFM well I literally couldn't.
I'm spitting at my screen like it's adobe's face while reading all that
https://giphy.com/gifs/wwe-wrestling-l0HU5bbgdW6qzJsmQ
I can sort of see the reason behind it. If they're hosting the manual then they can keep it updated (typos/mistakes/changes etc.). Printed manuals can become outdated by the time it reaches the buyer.
What they should've done instead was to include a printed version, and then add a QR code to see the latest version online. That would've been very handy
The thing is it's not the entire manual, just one (half) single page that tell me which pins doing what.
The printed manual is for this specific model (with exact rev. Version) and with the rest of the information available.
The physical pins on this board is not going to randomly change themselves.
This was never a problem with manuals when they were hosted offline.
What, the product magically changes during shipping?
Are they updating the pin layout after I bought the motherboard somehow? The dude didn't say it was the whole manual. Just the pin layout on the actual hardware.
Even if it was the whole manual: the hardware won't be updated. The BIOS could be, but that's like one little section of the manual most of the time and would be the only thing to make sense to send a user to a webpage for. All the info about the physical thing will never change, so needing it online to be updated is unnecessary.