2 ms·
Agreed. Fill your tech docs with marketing crap (like spelling out Foozitronic Ambizlaber Frombulator Tessagram in full every time it is mentioned, or inflatin
by dredmorbius 5y ago
Agreed.
Fill your tech docs with marketing crap (like spelling out Foozitronic Ambizlaber Frombulator Tessagram in full every time it is mentioned, or inflating claims as you've noted --- a powerful value subtraction method) and I will 1) run screaming 2) block your website at the router by DNS and ASN, 3) rely only on third-party independent documentation and 4) if at all possible find an alternate option or solution.
If I'm reading your tech docs, you've already sold me your shit, I've got a problem with it, and you're well on your way to unselling me on it. Your job is to not fuck shit up worse than it already is.
Let the trademark lawyers stick their mandatory talismanic incantations at the preface of the doc, and keep sales and marketing the fuck away.
Good docs (and good end-user support) are worth their weight in gold.
I can remember two specific sessions I had, both in the 1990s. One was for setting up an X terminal emulator on PCs, using XDMCP, where it turned out that the phone support was in fact a brain surgeon (well, neurology med student), another for a data analysis tool who walked me through IBM data formats for about two hours --- I could tell you their first and last names, this support rep was a legend among the users of that particular software.