4 ms·
I love the math pages on Wikipedia but I have a math degree. They are written (written clearly and concisely) for mathematicians. If you're a programmer (but d
by chongli 2y ago
I love the math pages on Wikipedia but I have a math degree. They are written (written clearly and concisely) for mathematicians.
If you're a programmer (but don't have a math degree) then I would offer up API docs as a comparison. They are written for you, the user of the API, to be as concise and straightforward as possible so that you can get up and running with the API. API docs are definitely not written for beginners who have never written a line of code (or a line of code in the language the API is written in) before.
If there's one complaint I may entertain, it's that Wikipedia isn't supposed to be a resource for specialists. It's intended to be an encyclopedia for a general audience. But then by that reasoning, many of these math pages on Wikipedia probably ought to be deleted outright because they're simply too specialized in the first place. So we're left with the dilemma: do we keep these articles as-is (and keep mathematicians happy) or do we delete them outright because they're too specialized?
The third option, rewriting them for a general audience, is likely to run afoul of Aesop's fable #721 "The miller, his son, and the donkey" [1]. You'll get a highly technical and complex article that explains far too much and buries its insights in overly verbose and cumbersome prose (which cannot assume any prerequisite mathematical knowledge). It'll please neither the mathematician nor the general audience member.
[1] https://en.wikipedia.org/wiki/The_miller,_his_son_and_the_donkey https://en.wikipedia.org/wiki/The_miller,_his_son_and_the_do...