Category:Pedias: Difference between revisions

imported>Ixxie
imported>Ixxie
Added more clauses to language section.
Line 5: Line 5:
==Language==
==Language==


Discussion articles should be written in clear, standard and professional language. To this end, the following heuristics apply:
Discussion articles should be written in clear, standard and professional language. To this end, the following considerations apply:


* ''Vocabulary'': use the simplest and most conventional words and expressions you can find to get your point across without oversimplifying.
* ''Vocabulary'': use the simplest and most conventional words and expressions you can find to get your point across without oversimplifying.
* ''Organization'': keep your text structured in coherent sentences, paragraphs and sections, each with its own clear themes and topics.
* ''Organization'': keep your text structured in coherent sentences, paragraphs and sections, each with its own clear themes and topics.
* ''Citations'': citations aren't required, but definitely appreciated; when citing code, hardlink to a particular revision.
* ''Citations'': citations aren't required, but definitely appreciated; when citing code, hardlink to a particular revision.
* ''Attribution'': where external material is quoted or utilized in the article, and/or licensing or common sense demands it, place clear and complete attribution and (where possible) a link.
* ''Code'': code examples should be cogent and illustrative of the surrounding text (otherwise they would normally go in one of the other article types).


==Canonical Forms==
==Canonical Forms==