[WikiEN-l] Accessibility of technical articles
There has been some interesting debate on the site about technical articles. There has been some (fairly heated) discussion here: http://en.wikipedia.org/wiki/Wikipedia_talk:FAC#Some_thoughts_from_an_FA-newbie (That discussion is mostly over, so best not to stir it up again). And more here: http://en.wikipedia.org/wiki/Wikipedia_talk:Make_technical_articles_understandable#Guideline_status_restored And the section immediately below it. I found it ironic that when I discussed a particular article here: http://en.wikipedia.org/wiki/User_talk:CBM#Mathematics_article_I_found_difficult The edit that was made to make the article more accessible (to me, at least), was reverted: http://en.wikipedia.org/w/index.php?title=Poincar%C3%A9_conjecturediff=prevoldid=414368190 With the edit summary: It's a boundary not a surface--but no need to put in the lede, people can follow the link). Unfortunately, following the link didn't really help me. In mathematics, a 3-manifold is a 3-dimensional manifold. The topological, piecewise-linear, and smooth categories are all equivalent in three dimensions, so little distinction is made in whether we are dealing with say, topological 3-manifolds, or smooth 3-manifolds. I found the edit made to the original article much clearer, in that it said that the 3-sphere is the the surface of the [[unit ball]] in four-dimensional space. I suppose adding the word informally might soothe mathematicians who insist on precise language. Carcharoth ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
To take the Poincare conjecture example, compare the Wikipedia article to this accessible explanation. Should the Wikipedia article incorporate explanatory aspects similar to those used in the SEED magazine article? http://en.wikipedia.org/wiki/Poincar%C3%A9_conjecture http://seedmagazine.com/content/article/what_is_the_poincare_conjecture/ I can say without a shadow of a doubt that I found the SEED magazine article more accessible and I learnt more from it. Carcharoth ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
This is typical sophomoric writing, sometimes literally done by 2nd year students, actual sophomores. It is not limited to math; my particular pet peeve is our philosophy articles. A skilled teacher with years of experience teaching at the college level can often make such subjects much more understandable. Fred There has been some interesting debate on the site about technical articles. There has been some (fairly heated) discussion here: http://en.wikipedia.org/wiki/Wikipedia_talk:FAC#Some_thoughts_from_an_FA-newbie (That discussion is mostly over, so best not to stir it up again). And more here: http://en.wikipedia.org/wiki/Wikipedia_talk:Make_technical_articles_understandable#Guideline_status_restored And the section immediately below it. I found it ironic that when I discussed a particular article here: http://en.wikipedia.org/wiki/User_talk:CBM#Mathematics_article_I_found_difficult The edit that was made to make the article more accessible (to me, at least), was reverted: http://en.wikipedia.org/w/index.php?title=Poincar%C3%A9_conjecturediff=prevoldid=414368190 With the edit summary: It's a boundary not a surface--but no need to put in the lede, people can follow the link). Unfortunately, following the link didn't really help me. In mathematics, a 3-manifold is a 3-dimensional manifold. The topological, piecewise-linear, and smooth categories are all equivalent in three dimensions, so little distinction is made in whether we are dealing with say, topological 3-manifolds, or smooth 3-manifolds. I found the edit made to the original article much clearer, in that it said that the 3-sphere is the the surface of the [[unit ball]] in four-dimensional space. I suppose adding the word informally might soothe mathematicians who insist on precise language. Carcharoth ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
Actually, I think the point of the mathematics articles, is that many of them (especially the more advanced ones) are written and used by practising mathematicians. See the comment here: http://en.wikipedia.org/wiki/w/index.php?title=Wikipedia_talk%253AWikiProject_Mathematicsaction=historysubmitdiff=408581050oldid=408567259 So some might object to your use of the term sophomore, but the rest I agree with. You need people who have experience explaining things to make things like that accessible, but I would suggest technical writers and those who are good at popularising and explaining science and maths topics. Carcharoth On Thu, Feb 17, 2011 at 1:57 PM, Fred Bauder fredb...@fairpoint.net wrote: This is typical sophomoric writing, sometimes literally done by 2nd year students, actual sophomores. It is not limited to math; my particular pet peeve is our philosophy articles. A skilled teacher with years of experience teaching at the college level can often make such subjects much more understandable. Fred There has been some interesting debate on the site about technical articles. There has been some (fairly heated) discussion here: http://en.wikipedia.org/wiki/Wikipedia_talk:FAC#Some_thoughts_from_an_FA-newbie (That discussion is mostly over, so best not to stir it up again). And more here: http://en.wikipedia.org/wiki/Wikipedia_talk:Make_technical_articles_understandable#Guideline_status_restored And the section immediately below it. I found it ironic that when I discussed a particular article here: http://en.wikipedia.org/wiki/User_talk:CBM#Mathematics_article_I_found_difficult The edit that was made to make the article more accessible (to me, at least), was reverted: http://en.wikipedia.org/w/index.php?title=Poincar%C3%A9_conjecturediff=prevoldid=414368190 With the edit summary: It's a boundary not a surface--but no need to put in the lede, people can follow the link). Unfortunately, following the link didn't really help me. In mathematics, a 3-manifold is a 3-dimensional manifold. The topological, piecewise-linear, and smooth categories are all equivalent in three dimensions, so little distinction is made in whether we are dealing with say, topological 3-manifolds, or smooth 3-manifolds. I found the edit made to the original article much clearer, in that it said that the 3-sphere is the the surface of the [[unit ball]] in four-dimensional space. I suppose adding the word informally might soothe mathematicians who insist on precise language. Carcharoth ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
On 17 February 2011 14:16, Carcharoth carcharot...@googlemail.com wrote: So some might object to your use of the term sophomore, but the rest I agree with. You need people who have experience explaining things to make things like that accessible, but I would suggest technical writers and those who are good at popularising and explaining science and maths topics. Yyyesss. A working subject matter expert who also happens to be a brilliant and lucid writer would be *ideal*, but in practice someone with sufficient broad knowledge and writing skill to do a reasonable piece of (what is effectively) science journalism is what we actually have in the best case. And really, that's pretty good. Channel your inner Isaac Asimov. More often, we get (as Fred describes) an interested student who hopefully can also write a bit, and *that's not bad*. At worst we have a semi-opaque technical data dump, but that's still better than no article at all, and Wikipedia is after all a work in progress ... - d. ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
On Thu, Feb 17, 2011 at 3:15 PM, David Gerard dger...@gmail.com wrote: On 17 February 2011 14:16, Carcharoth carcharot...@googlemail.com wrote: So some might object to your use of the term sophomore, but the rest I agree with. You need people who have experience explaining things to make things like that accessible, but I would suggest technical writers and those who are good at popularising and explaining science and maths topics. Yyyesss. A working subject matter expert who also happens to be a brilliant and lucid writer would be *ideal*, but in practice someone with sufficient broad knowledge and writing skill to do a reasonable piece of (what is effectively) science journalism is what we actually have in the best case. And really, that's pretty good. Channel your inner Isaac Asimov. However, one of the arguments being put forward is that too much explanation breaches the provisions against not a textbook and original research (i.e. providing your own opinions instead of sourcing it to others). I have some sympathy with that viewpoint, and the view that there is a need to balance these issues that are in tension with each other. Carcharoth ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
On 17/02/2011 13:19, Carcharoth wrote: To take the Poincare conjecture example, compare the Wikipedia article to this accessible explanation. Should the Wikipedia article incorporate explanatory aspects similar to those used in the SEED magazine article? http://en.wikipedia.org/wiki/Poincar%C3%A9_conjecture http://seedmagazine.com/content/article/what_is_the_poincare_conjecture/ I can say without a shadow of a doubt that I found the SEED magazine article more accessible and I learnt more from it. Unfortunately the magazine article completely ducks the issue of what the conjecture is. Even on a charitable view, it confuses a necessary with a sufficient condition, which would be the *whole point*. This kind of this is actually why this one has not been solved yet on WP: we (rightly) don't allow people to waffle around the facts in order to claim they are explaining. (If you think we do badly, have a look at a standard mathematical encyclopedia: http://eom.springer.de/p/p073000.htm.) Charles ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
On Thu, Feb 17, 2011 at 4:58 PM, Charles Matthews charles.r.matth...@ntlworld.com wrote: On 17/02/2011 13:19, Carcharoth wrote: To take the Poincare conjecture example, compare the Wikipedia article to this accessible explanation. Should the Wikipedia article incorporate explanatory aspects similar to those used in the SEED magazine article? http://en.wikipedia.org/wiki/Poincar%C3%A9_conjecture http://seedmagazine.com/content/article/what_is_the_poincare_conjecture/ I can say without a shadow of a doubt that I found the SEED magazine article more accessible and I learnt more from it. Unfortunately the magazine article completely ducks the issue of what the conjecture is. Even on a charitable view, it confuses a necessary with a sufficient condition, which would be the *whole point*. This kind of this is actually why this one has not been solved yet on WP: we (rightly) don't allow people to waffle around the facts in order to claim they are explaining. (If you think we do badly, have a look at a standard mathematical encyclopedia: http://eom.springer.de/p/p073000.htm.) Hmm. Tricky one. Would you put a link to that magazine article in the external links? It might be missing the point, but it does give a different perspective and a less dry one. Carcharoth ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
On Thu, Feb 17, 2011 at 3:15 PM, David Gerard dger...@gmail.com wrote: On 17 February 2011 14:16, Carcharoth carcharot...@googlemail.com wrote: So some might object to your use of the term sophomore, but the rest I agree with. You need people who have experience explaining things to make things like that accessible, but I would suggest technical writers and those who are good at popularising and explaining science and maths topics. Yyyesss. A working subject matter expert who also happens to be a brilliant and lucid writer would be *ideal*, but in practice someone with sufficient broad knowledge and writing skill to do a reasonable piece of (what is effectively) science journalism is what we actually have in the best case. And really, that's pretty good. Channel your inner Isaac Asimov. However, one of the arguments being put forward is that too much explanation breaches the provisions against not a textbook and original research (i.e. providing your own opinions instead of sourcing it to others). I have some sympathy with that viewpoint, and the view that there is a need to balance these issues that are in tension with each other. Carcharoth Information needs to be usable by people with a wide range of competence. A well written article presents information in layers geared to the likely range of potential readers. I've had some luck with well-written textbooks, not copying them but using the way they explain things. That vitiates the original research objection. Fred ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
On 17 February 2011 17:09, Carcharoth carcharot...@googlemail.com wrote: Hmm. Tricky one. Would you put a link to that magazine article in the external links? It might be missing the point, but it does give a different perspective and a less dry one. Something technical but right is 100% better than something highly readable and clearly wrong. That said, the trouble with obsessive nerds who want things 100% right is that articles become hideous unreadable thickets of subclauses. But then, research appears to be a more widely available skill than good writing. - d. ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
On 17 February 2011 17:52, David Gerard dger...@gmail.com wrote: That said, the trouble with obsessive nerds who want things 100% right is that articles become hideous unreadable thickets of subclauses. But then, research appears to be a more widely available skill than good writing. Or is it because writing well is difficult, and writing accurately is difficult, and writing well AND accurately is difficulty squared? Nah, that would be ridiculous, it's just obsessive nerds who are broken; of course. - d. -- -Ian Woollard ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
On 17/02/2011 17:09, Carcharoth wrote: On Thu, Feb 17, 2011 at 4:58 PM, Charles Matthews charles.r.matth...@ntlworld.com wrote: On 17/02/2011 13:19, Carcharoth wrote: To take the Poincare conjecture example, compare the Wikipedia article to this accessible explanation. Should the Wikipedia article incorporate explanatory aspects similar to those used in the SEED magazine article? http://en.wikipedia.org/wiki/Poincar%C3%A9_conjecture http://seedmagazine.com/content/article/what_is_the_poincare_conjecture/ I can say without a shadow of a doubt that I found the SEED magazine article more accessible and I learnt more from it. Unfortunately the magazine article completely ducks the issue of what the conjecture is. Even on a charitable view, it confuses a necessary with a sufficient condition, which would be the *whole point*. This kind of this is actually why this one has not been solved yet on WP: we (rightly) don't allow people to waffle around the facts in order to claim they are explaining. (If you think we do badly, have a look at a standard mathematical encyclopedia: http://eom.springer.de/p/p073000.htm.) Hmm. Tricky one. Would you put a link to that magazine article in the external links? It might be missing the point, but it does give a different perspective and a less dry one. Actually I wouldn't in that case; but I might in the case of a more Scientific American-style treatment. By the way, I'm not saying that the exposition of mathematical articles, and in particular the lead sections, cannot be improved, because in most cases it can. There is the issue of finding some middle ground between an accurate factual treatment (with wikilinks of technical terms) which is what a mathematician from another field would want, and a more popular treatment. Compare for example http://en.wikipedia.org/wiki/E8_%28mathematics%29, and in particular the fourth paragraph of the fourth section on Representation theory, with http://www.aimath.org/E8/. The latter treatment is a decent example of the media coverage that a certain computation received not that long ago: but you can't extract from it exactly what was done (just that people thought it was exciting, and some general context). Anyway, I think this issue is going to remain with us. My experience with expository writing is that, no matter how much effort you put into the basics, there will always be someone who thinks you should do more. Charles ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l
Re: [WikiEN-l] Accessibility of technical articles
Here is my attempt at a historical explanation for the way things are at the moment. First, mathematicians in general are often reluctant to say things that are mostly right but formally incorrect. It's part of the culture of the field, which was reinforced by a certain writing style that became popular in advanced mathematics in the later 20th century. Second, for a few years there was a lot of pressure on Wikipedia to tighten up the referencing on math articles. Writing techniques that were commonly accepted in the early days, like inventing examples or making up informal analogies, were suddenly deemed original research. Edits like this [1] are not rare today, where someone thought that a section that seemed easy and informal must actually be OR. Fortunately the examples in that section are actually covered in many textbooks, so I could just add a citation. But if the example was written just for Wikipedia, it would be very hard to maintain if someone seriously challenged its inclusion. The current state of many math articles reflects a combination of these trends. When we were asked (not always nicely) to make math articles stick to the sources, which are usually written in a dry, technical way, math editors mostly agreed. After all, we can read the sources, so we can read articles that resemble them. Recently, there has been talk of making articles more accessible. But many of the tools that we would use in other writing aren't available. * We can't just leave out the technical bits, like most popularizations do. * We can't invent examples and explain them in detail, because of the original research policy and because Wikipedia isn't a textbook. * We can't freely use analogies and informal explanations, for the same reasons (see [1] again). Many math editors care about accessibility, of course. But the confines that we are asked to write in are very tight, which makes it a particular challenge. - Carl 1: http://en.wikipedia.org/w/index.php?title=Kleene%27s_recursion_theoremdiff=413952471oldid=413931670 ___ WikiEN-l mailing list WikiEN-l@lists.wikimedia.org To unsubscribe from this mailing list, visit: https://lists.wikimedia.org/mailman/listinfo/wikien-l