Difference between revisions of "PEGWiki:PEGWiki is not an encyclopedia"

From PEGWiki
Jump to: navigation, search
(Created page with 'PEGWiki runs on the very popular [http://www.mediawiki.org/ MediaWiki] software. One site that uses MediaWiki that is particularly well-known is [http://en.wikipedia.org/ Wikiped…')
 
Line 1: Line 1:
PEGWiki runs on the very popular [http://www.mediawiki.org/ MediaWiki] software. One site that uses MediaWiki that is particularly well-known is [http://en.wikipedia.org/ Wikipedia]. One might be tempted to think that PEGWiki serves a similar purpose to that of Wikipedia. It does not. PEGWiki is both similar and dissimilar to an encyclopedia.<br/>
+
PEGWiki runs on the very popular [http://www.mediawiki.org/ MediaWiki] software. One site that uses MediaWiki that is particularly well-known is [http://en.wikipedia.org/ Wikipedia]. One might be tempted to think that PEGWiki serves a similar purpose to that of Wikipedia. It does not. If it did, then it would be pointless to write articles about computer science for PEGWiki (when one could simply add them to Wikipedia instead). At least one article has already been copied from here to there, and was found to be written in a style unsuitable for Wikipedia. This is to be expected, because PEGWiki articles are intended to read as tutorials, not as reference texts.
<br/>
+
 
PEGWiki should contain whatever content is useful, interesting, or beneficial for PEG, and it should be driven by members of PEG. This does not mean that non-members are barred from contributing. If you are not a member of PEG, feel free to contribute to articles that you feel you could improve, such as those describing algorithms and data structures. However, the level and style of the article should be appropriate for PEG. So, for example, if you think an explanation is incomplete, poorly written, or confusing, then by all means improve it, but don't rewrite sections to make them more understandable for the non-computer-literate; also, pages describing algorithms and data structures, such as [[Computational geometry]], should have the primary purpose of educating the reader so that he or she can apply the techniques described, and not the tempting but incorrect purpose of simply collecting all the information about that topic (even if it is presented in the most interesting way possible). In effect, although PEGWiki is not a textbook either, it is much more similar to a textbook than it is to an encyclopedia.
+
Furthermore, the level and style of the article should be appropriate for PEG. So, for example, if you think an explanation is incomplete, poorly written, or confusing, then by all means improve it, but don't rewrite sections to make them more understandable for the non-computer-literate; they are not the intended audience.

Revision as of 01:19, 11 December 2011

PEGWiki runs on the very popular MediaWiki software. One site that uses MediaWiki that is particularly well-known is Wikipedia. One might be tempted to think that PEGWiki serves a similar purpose to that of Wikipedia. It does not. If it did, then it would be pointless to write articles about computer science for PEGWiki (when one could simply add them to Wikipedia instead). At least one article has already been copied from here to there, and was found to be written in a style unsuitable for Wikipedia. This is to be expected, because PEGWiki articles are intended to read as tutorials, not as reference texts.

Furthermore, the level and style of the article should be appropriate for PEG. So, for example, if you think an explanation is incomplete, poorly written, or confusing, then by all means improve it, but don't rewrite sections to make them more understandable for the non-computer-literate; they are not the intended audience.