Content deleted Content added
What code formatting convention should be used? |
outside examples |
||
Line 91:
What's [http://en.wikipedia.org/w/index.php?title=Eiffel_programming_language&diff=52354486&oldid=51516199 wrong] with starting a sentence with "begun"? --[[User:P3d0|P3d0]] 19:57, 9 May 2006 (UTC)
== What code formatting convention should be used? ==
The font conventions and in particular the use of blue for program texts are part of Eiffel's style conventions. Whatever rules are applied in the descriptions of other languages are not applicable here. Thanks for respecting the specific rules for Eiffel. [[User:Bertrand Meyer|B-Meyer]] 17:18, 20 August 2006 (UTC)
Line 120:
:The typographic issue is somewhere in the middle of where the content's conventions intersect with the conventions of Wikipedia. For example, I've worked on the [[Python programming language]] article, and think it would be utterly foolish to say that Python code examples should not use that language community's traditional "spam" and "eggs" meta-variables because most programming languages, because most programming language articles use "foo" and "bar" or "x" and "y". At the other extreme, many commercial products (in software, or in completely unrelated areas)—or for that matter, many religions or other beliefe systems—use a set of jargon intended to create a positive impression of the product. Wikipedia absolutely ''should not'' adopt the "feel" of the way marketers talk about their particular product (mentioning the usage, sure; but not adopting it). I think in the end the best solution will be one suggested above: use the Eiffel-style code coloration for block examples, but use Wikipedia style for inline examples (and make sure the unusual block example style is explained in the text). But I'll wait for some more opinion, and check some other usages. <font color="darkgreen">[[User:Lulu of the Lotus-Eaters|LotLE]]</font>×<font color="darkred" size="-2">[[User talk:Lulu of the Lotus-Eaters|talk]]</font> 01:12, 22 August 2006 (UTC)
=== Data points ===
Looking at "the rest of the world" I find (<font color="darkgreen">[[User:Lulu of the Lotus-Eaters|LotLE]]</font>×<font color="darkred" size="-2">[[User talk:Lulu of the Lotus-Eaters|talk]]</font>):
* The FAQ for the GNU SmartEiffel project at http://smarteiffel.loria.fr/wiki/en/index.php/FAQ ''does not'' use blue for either inline or block examples, but simply <nowiki><pre></nowiki> and <nowiki><code></nowiki>.
...more to follow
| |||