View source for WikiIslam:Writing Style Guide

It is often difficult for new editors at [[WikiIslam]] to understand what is or is not appropriate within articles. This page expands on the site's [[WikiIslam:Policies and Guidelines|policies and guidelines]] concerning style, tone and content of its articles by providing a visual guide for editors.
{{shortcut|[[WISCG]]}}
==Examples==

The following tables provide examples of correct and incorrect style, tone and content. All of these examples are genuine edits that were either reverted or amended. Note that there may be some overlap in examples, and a sentence having an issue corrected does not mean the remaining sentence is free from error (it may have multiple issues).

===Style & Tone===

{| class="wikitable"
|-
! width = 33% | Incorrect {{spaces|1}}[[File:Cross.png]]
! width = 33% |Corrected [[File:Checkmark.svg|20px]]
! Notes
|-
| ''Dr. Omar Abdul Rehman’s article is clearly the most detailed, and we will use it as the basis for our rebuttal as it includes all the QEP nonsense of Drs' Keith Moore and Maurice Bucaille.''
| ''Dr. Omar Abdul Rehman’s article is clearly the most detailed, and we will use it as the basis for our analysis as it includes all the QEP claims of Drs' Keith Moore and Maurice Bucaille.''
| The harsh and unprofessional tone of the sentence has been replaced. 
|-
| ''Because of this double standard, countries such as France, Belgium, Italy, and the Netherlands have banned people concealing their identity in public completely.''
| ''Because of this conflicting standard,  [...]''
| The term "double-standard" has been replaced with a more neutral word.
|-
| ''this is another of the absurd pseudo-scientific claims of the champion of Qur'anic Pseudo-Science, Maurice Bucaille.''
| ''this is another pseudo-scientific claim made by Maurice Bucaille.''
| Sarcasm, humor or insults should be avoided.
|-
| ''Aisha even started a war against her old enemy Ali, causing ten thousand Muslims to kill each other in one day.'' 
| ''Aisha began a war against Ali that resulted in ten thousand fatalities in one day.'' 
| Avoid writing in an emotional, dramatic style. State the facts and nothing else. 
|-
| ''He isn't specific on the time frame, offering up a number of years but not definitely stating that it is exact.  He doesn't mention any names, fails to mention where these events take place, and doesn't state when this story happened. '' 
| ''He is not specific on the time frame, offering a number of years but nothing definitive. He does not mention any names, fails to mention where these events took place, and does not state when this story happened.'' 
| Do not use contracted forms (e.g. "doesn't", "isn't") when you should use "is not", "does not" etc. 
|-
| ''So how, we must ask, is the early universe anything like "smoke"?'' 
| ''There is no similarities between the early universe and smoke.'' 
|  The use of first or second person in writing ("we" and addressing the reader) should be avoided. Either reword or remove these sections.
|}

===Content===

{| class="wikitable"
|-
! width = 33% | Incorrect {{spaces|1}}[[File:Cross.png]]
! width = 33% |Corrected [[File:Checkmark.svg|20px]]
! Notes
|-
| ''The Qur'an relates that God has woken the sleepers as a way to test who could calculate the length of their stay the best.''
| ''The Qur'an relates that Allah has woken the sleepers as a way to test who could calculate the length of their stay the best.''
| When referring to Islam's deity, always use his proper name (i.e. Allah) rather than the generic English term "God" (or the Arabic equivalent "Illah").
|-
| '' Hiding your identity in public this way is completely legal in many western countries, whilst other face coverings such as balaclavas, masks, and motorcycle helmets will quickly get the wearer arrested if worn in a public place.''
| ''Hiding your identity in public this way is legal in many countries  [...]''
| There is no reason for singling-out/providing undue attention to "western" countries when the issue being discussed applies equally to non-western countries.
|-
| ''The Gregorian calendar did not exist in Muhammad’s day, so reporting dates in Gregorian style is an anachronism. The Europeans used the Julian calendar, which was then only two or three days variant from the Gregorian. However, it will be convenient to compare Muhammad’s calendar with the one currently used by the majority of readers.'' 
| ''The Gregorian calendar did not exist in Muhammad’s day, so reporting dates in Gregorian style is an anachronism. However, it will be convenient to compare Muhammad’s calendar with the Gregorian calendar, which is internationally the most widely accepted and used civil calendar.'' 
| There is no reason to assume the target-audience are Europeans. In fact, while demographics vary from week to week, visitors from Africa and Asia often outnumber those from Europe or the United States. Material should be tailored to accommodate, as best as possible, a universal audience.  
|-
| ''If this is the sort of thing Islamists are ready to propagate openly with the approval and endorsement of authorities, Universities and so many sponsors, then what other lies do they feed to children at Muslim schools, and to young adults at mosques? Why are so many of the non-Muslim governments and individuals who continue to perpetuate these myths via websites and forums so eager to appease Muslims and show that their culture produced superior inventions by taking rightful credits from other civilizations such as ancient China, ancient Rome, and pre-Islamic Egypt? '' 
| (avoid) 
| Opinionated rants are to be avoided. This is not an anti-jihad site or blog for airing ones frustrations concerning perceived wrongs in society. 
|-
| ''Shahid (شَهيد , plural: شُهَداء šuhadā) is an Islamic term for a martyr. As with adultery and justice, the term martyr in Islam differs from the secular and Biblical definitions of the word.'' 
| ''Shahid (شَهيد , plural: شُهَداء šuhadā) is an Islamic term for a martyr. As with adultery and justice, the term martyr in Islam differs from the commonly agreed upon definitions of the word.'' 
| Commentary on other religious traditions should be avoided. In this case, the Christian (or even Buddhist and Hindu) definitions would likely mirror the secular ones, so it is unnecessary to make a distinction.  
|-
| ''The fact that the earth is not flat has been known for thousands of years. The Rigveda of Hindus (1700 BC or older), The Ancient Greeks Pythagoras (570 - 495 BC), Aristotle (384 - 322 BC) and Hipparchus (190 - 120 BC) all knew this. The Indian astronomer and mathematician, Aryabhata (476 - 550 AD) knew this.'' 
| ''The fact that the earth is not flat has been known for thousands of years. The Ancient Greeks Pythagoras (570 - 495 BC), Aristotle (384 - 322 BC) and Hipparchus (190 - 120 BC) all knew this. The Indian astronomer and mathematician, Aryabhata (476 - 550 AD) knew this.'' 
| Positive and definitive claims about what other religious texts (Bible, Rigveda, etc.) say should be avoided because such texts are open to interpretation and our aim is to remain neutral towards them. The examples given are sufficient and already cover India, so mentioning the Rigveda is unnecessary.
|}

===Presentation of Facts===

{| class="wikitable"
|-
! width=33% | Incorrect {{spaces|1}}[[File:Cross.png]]
! width = 33% |Corrected [[File:Checkmark.svg|20px]]
! Notes
|-
| ''Time would show that Aisha was confident, spirited, strong-willed and highly intelligent – she had indeed “some of the qualities of Khadijah”.''
| (avoid)
| This sentence draws conclusions from text that can be debated. There are no hadiths that mention explicitly that Aisha was 'intelligent', 'strong willed' and so on. Report facts and not  opinions and deductions.
|-
| ''he must have been a good stepfather to Hala and Hind, for they remained unswervingly loyal to him.''
| (avoid)
| This sentence is drawing conclusions that are not present in the original text. Stepchildren remaining loyal could equally suggest that Muhammad was a strict and uncaring disciplinarian. But since neither conclusion is supported by facts, commenting on them should be avoided.
|-
| ''Juwayriya was sweet-natured, charming and as alluringly beautiful as a fairy; men became infatuated with her at first sight.''
| ''Juwayriya was described in some hadiths as "jinnya" which some dictionaries translate to "angel like".''
| An editor's own conclusions or exaggerations are being replaced with facts. 
|}<BR>

==See Also==

* [[WikiIslam:Policies and Guidelines]]
* [[WikiIslam:Forum/Help and Inquiries]]

[[Category:Policies and Guidelines]]