Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

> The very first search result for "windows dev kit"

Somewhere I saw a link, URL, to a Microsoft Web page describing the Dev Kit and followed that link. The link was not the one you gave. And I didn't get the link from a Google search or from this Hacker News thread. In another post to this thread, I gave the URLs I tried, and none of them was the URL you gave.

How did I waste some hours on this? For the URLs I tried, it was tough to make any sense out of what they were talking about -- the writing assumed too much background for the reader and used too much poorly defined jargon.

E.g., I didn't know what a

Snapdragon 8cx Gen 3 Compute Platform

was! That is from QUALCOMM. One of the founders was Andrew Viterbi, and he was a good mathematician who worked in coding theory. I had a graduate course in coding theory that mentioned Viterbi. So, on QUALCOMM, I have a background in some of the technical work of one of the founders. Alas, the course didn't mention a

Snapdragon 8cx Gen 3 Compute Platform

I've taught computer science ugrad at Georgetown U and grad level at Ohio State U but never mentioned the

Snapdragon 8cx Gen 3 Compute Platform

I suspect that could find a lot of graduate computer science courses at MIT, CMU, ..., Stanford that never mention the

Snapdragon 8cx Gen 3 Compute Platform

Net, there is an epidemic problem in the practical computer industry -- too much poorly defined jargon.



The sheer volume of text you have written about this is very strange. You may want to seek guidance on how to interact with other people. Have a good weekend.


Right: Some people here at Hacker News like to attack others that don't fit in with some of the norms. Mere technical discussions are not always welcome.

My background is quite different, is with people who can engage in technical communications with objectivity.

Yup, you are right: Some people at Hacker News have trouble being objective. To interact with them, be like a politician who is careful never to say much of anything except they like motherhood and apple pie.

In part my goal was to let Microsoft and much of the tech community know that they very much need to improve their technical writing. Microsoft has made a lot of improvements, but for their Dev Kit they fell back into poor writing again. One rule that would help a lot would be to avoid undefined or poorly defined jargon, terminology, or acronyms.

Your arguments about URLs fails to make a valid point: There are a lot of URLs about the Dev Kit, and the ones you mentioned and their sources are not necessarily where I got the URLs I followed. So, your claim that I ignored good URLs that were right in front of me was wrong: The sources you mentioned were not the ones I happened to use.

I'm 100% correct: Some of the Microsoft publicity, promotion, and documentation of their Dev Kit has some really obscure technical writing that can waste a lot of time for people without a quite narrow background. For making this point, you have attacked ME. Hmm ....




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: