Plain English

From Plain English Campaign (www.plainenglish.co.uk )

Plain English is defined as "language that the intended audience can understand and act upon from a single reading".

While this is a technical forum, and technical language is necessary for clarification, in all other cases write using plain English. Write professionally. Write clearly. Writing on Wiki is an opportunity to improve your writing.

This is one of the Wiki Social Norms.

Some extreme cases:

Signatures should normally read like the names of people. Mostly real people. Never organizations or pressure groups. Real Names Please.

{[Delete Me] if this {[[[New Refactoring Instruction]]] gets too recursive}} is harder to understand yet contains less signal than a space line.

UgLy page names should be avoided because they are harder to read.

Horizontal lines are preferred over brackets spanning multiple paragraphs, wherever possible. Re Factoring Suggestion For Plain English

The use of wiki word grouping mechanisms as in Camel Case are departures from Plain English. They are used in ways that can either clarify or confuse. Choice of a Camel Case word is an unexact methodology which utilizes creative talent some of us have yet to develop. Therefore when choosing between using a Camel Case word and Plain English, defer more often to Plain English.

Although "Wiki is going to the dogs" was originally a good joke, it shouldn't be repeated too many times. Use XML only for XML.

"SeeAlso" is less readable than "See also" or "See". It is also less useful. Create links to topical content, not meta-content. Don't waste the reader's attention by offering a click to nothing.

"lol", "rofl", and emoticons are fine when text is scrolling rapidly in a chat room, but seem trite when they remain for more than thirty seconds. See Emotion On Wiki for tips on how to express emotional reactions when appropriate.


Confusion about Plain English:

The title of this page for example is confusing. Is it a noun or an imperative instruction? Perhaps Eschew Obfuscation would be a clearer title? :o) -- Andrew Cates

Perhaps another confusion some have is that if one expresses something in abstraction, that does not exclude it from being "Plain English". From abstractions one can manufacture multitudes of personalized instances. Some wish to reduce the clutter of stating all possible instances, or limiting the expressions to instances, by abbreviating via abstraction. Abstraction is really a convenient and efficient use of language. -- Donald Noyes.20071106


The US government has a web site, www.plainlanguage.gov , that contains guidelines for communicating clearly. However, it doesn't communicate very well - try www.plainenglish.co.uk instead!


What about contributions to Wiki in other languages such as Agile Moedera? Use Wiki Translator?


Meaningful Names discusses choosing good variable names in software; perhaps that is related to choosing good Wiki Words.


I know of a programming language called "Plain English Programming" that you could try; is presented in www.osmosian.com and now I'm trying to program in with it. It would be interesting that you try it and tell everybody about the possible classification and limits of its paradigm. Pablo Cayuela 20131218



See original on c2.com