WikiIslam:Writing Style Guide: Difference between revisions

Jump to navigation Jump to search
m
(One intermediate revision by the same user not shown)
Line 308: Line 308:
|{{center|1}}
|{{center|1}}
|''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 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.''
|''Dr. Omar Abdul Rehman’s includes the QEP claims of Drs' Keith Moore and Maurice Bucaille.''
|The harsh and unprofessional tone of the sentence has been replaced.
|The harsh and unprofessional tone of the sentence has been replaced and made more concise
|-
|-
|{{center|2}}
|{{center|2}}
|''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 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, [...]''
|Omit - "''Because of this double standard, countries such as..."''
|The term "double-standard" has been replaced with a more neutral word.
|Editor should not conclude the state of affairs, leave this to the reader
|-
|-
|{{center|3}}
|{{center|3}}
|''this is another of the absurd pseudo-scientific claims of the champion of Qur'anic Pseudo-Science, Maurice Bucaille.''
|''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.''
|Omit
|Sarcasm, humor or insults should be avoided.
|Sarcasm, humor or insults should be avoided
Editors should not draw conclusions no matter how "obvious" they seem
|-
|-
|{{center|4}}
|{{center|4}}
|''Aisha even started a war against her old enemy Ali, causing ten thousand Muslims to kill each other in one day.''
|''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.''
|''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.
|Avoid writing in an emotional, dramatic style. State the facts and nothing else
|-
|-
|{{center|5}}
|{{center|5}}
|''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 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 or where the events took place, and doesn't...''
|''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.''
|''He is not specific on the time frame, offering a number of years but nothing definitive. He does not mention any names or where the events took place, and does not...''
|Do not use contracted forms (e.g. "doesn't", "isn't") when you should use "is not", "does not" etc.
|Do not use contracted forms (e.g. "doesn't", "isn't") when you should use "is not", "does not" etc.
|-
|-
|{{center|6}}
|{{center|6}}
|''So how, we must ask, is the early universe anything like "smoke"?''
|''So how, we must ask, is the early universe anything like "smoke"?''
|''There is no similarities between the early universe and smoke.''
|Scientific Journal X addresses the early universe as...
|The use of first or second person in writing ("we" and addressing the reader) should be avoided. Either reword or remove these sections.
|The use of first or second person in writing ("we" and addressing the reader) should be avoided. Either reword or remove these sections.
|}
|}


== Analysis ==
==Analysis==
All and any analysis should not be labeled as an analysis and there should be no sections dedicated to or labeled as analysis—the whole article should be a comprehensive summary and analysis of scripture and scholarly sources. Thus, analysis will present itself throughout the article.
All and any analysis should not be labeled as an analysis and there should be no sections dedicated to or labeled as analysis—the whole article should be a comprehensive summary and analysis of scripture and scholarly sources. Thus, analysis will present itself throughout the article.


=== Acceptable analysis ===
===Acceptable analysis===
Includes that which brings together scholarly stances and/or direct scriptural references on a position and makes objective observations. The idea is to summarize the sources and allow the reader to determine how they support or conflict with one another. All positions mentioned should stay relevant to the subject of the article.
Includes that which brings together scholarly stances and/or direct scriptural references on a position and makes objective observations. The idea is to summarize the sources and allow the reader to determine how they support or conflict with one another. All positions mentioned should stay relevant to the subject of the article.


=== Unacceptable analysis ===
===Unacceptable analysis===
Includes any analysis that includes the editor’s own judgement, conclusions, impressions, evaluations, or ethics. It is also unacceptable for editors to judge intentions or character of any author, source, or person—real or fictional.  
Includes any analysis that includes the editor’s own judgement, conclusions, impressions, evaluations, or ethics. It is also unacceptable for editors to judge intentions or character of any author, source, or person—real or fictional.  


Line 360: Line 361:
|-
|-
|{{center|7}}
|{{center|7}}
|''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 Quran 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.''
|''The Quran 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").
|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").
|-
|-
Line 367: Line 368:
|'' 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 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  [...]''
|''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.
|Focus on the topic at hand and not bringing in comparative analysis
|-
|-
|{{center|9}}
|{{center|9}}
|''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. 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.''
|''The Gregorian calendar did not exist in Muhammad’s day. 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.
|Material should be tailored to accommodate, as best as possible, a universal audience.
|-
|-
|{{center|10}}
|{{center|10}}
Line 382: Line 383:
|''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 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.''
|''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.
|Commentary on other religious traditions should be avoided. In this case it s an unnecessary distinction. Unless the article is comparing religious parallels as the main subject.
|-
|-
|{{center|12}}
|{{center|12}}
|''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 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.''
|''The spherical nature of the Earth has been understood for thousands of years. Literature of this can be traced back to the Ancient Greeks, Pythagoras (570 - 495 BC), Aristotle (384 - 322 BC) and Hipparchus (190 - 120 BC) as well as Indian astronomer and mathematician, Aryabhata (476 - 550 AD).''
|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.
|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.
|-
|-
|{{center|13}}
|{{center|13}}
|''Further, this apologist has ignored...''
|''Further, this apologist has ignored...''
|''This argument also ignores...''
|''This argument ignores...''
|WikiIslam is not an "interfaith" or "dialogue" site, so unless it is someone very notable for work outside of the Internet, responses should not be made to specific, usually obscure, web-based apologists. Instead responses should be made to the general arguments raised, if those arguments merit a response at all.
|WikiIslam is not an "interfaith" or "dialogue" site, so unless it is someone very notable for work outside of the Internet, responses should not be made to specific, usually obscure, web-based apologists. Instead responses should be made to the general arguments raised, if those arguments merit a response at all.
|-
|-
|{{center|14}}
|{{center|14}}
|''<nowiki>==</nowiki>Verses Claiming that Quran is Detailed<nowiki>==</nowiki>''
|''<nowiki>==</nowiki>Verses Claiming that Quran is Detailed<nowiki>==</nowiki>''
|''<nowiki>==</nowiki>Qur'anic Claim<nowiki>==</nowiki>''
|''<nowiki>==</nowiki>Quranic Claim<nowiki>==</nowiki>''


The Qur'an claims several times that it is a book explained in detail:  
The Qur'an claims it is a book explained in detail: (citations)
|Section headings do not form a part of the main text. They only indicate the general topic of that particular section, and should not contain information not found within its main text. So when choosing titles for headings and subheading, editors should avoid questions or long sentences.
|Section headings do not form a part of the main text. They only indicate the general topic of that particular section, and should not contain information not found within its main text. So when choosing titles for headings and subheading, editors should avoid questions or long sentences.
|-
|-
Line 413: Line 414:
|{{center|17}}
|{{center|17}}
|''Juwayriya was sweet-natured, charming and as alluringly beautiful as a fairy; men became infatuated with her at first sight.''
|''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".''
|''Juwayriya was described in some hadiths as "jinnya" which some dictionaries translate to "angelic".''
|An editor's own conclusions or exaggerations are being replaced with facts.
|An editor's own conclusions or exaggerations are being replaced with facts.
|}
|}


== Lead vs Body ==
==Lead vs Body==


=== Lead ===
===Lead===
The Lead Text should define and explain only essential information about the subject and its impacts/contributions. The Lead Text text comes before the table of contents and does not have a section title. It is composed of one to four paragraphs and should be written simply and concisely to allow for easy digestion of information. This will also help Google create snippets for their search engine and therefore boosts the article’s visibility.
The Lead Text should define and explain only essential information about the subject and its impacts/contributions. The Lead Text text comes before the table of contents and does not have a section title. It is composed of one to four paragraphs and should be written simply and concisely to allow for easy digestion of information. This will also help Google create snippets for their search engine and therefore boosts the article’s visibility.


The lead text is the most important text in the article and should reflect the objective standard we are trying to achieve.
The lead text is the most important text in the article and should reflect the objective standard we are trying to achieve.


=== Body ===
===Body===
The body text should go into greater detail than the Lead text. It is important that all challengeable materials, or any claim that is subject to dispute, are from third party published works. The body should go into further details of interest on the subject and be broken down into sections.
The body text should go into greater detail than the Lead text. It is important that all challengeable materials, or any claim that is subject to dispute, are from third party published works. The body should go into further details of interest on the subject and be broken down into sections.


Where a source is open to interpretation or is disputed, editors should not assume a particular meaning. Interpretations can be discussed by reference to scholars. The editor should only seek to summarize and collect sources that accurately reflect the positions and dialogue concerning the article’s subject.  Articles should ''never'' end with an evaluation of the editor’s impression. In fact, the article should not have ending remarks at all, as they give a sense of finality and closure that discourages the reader from further research. The WikiIslam articles should aim only to provide the reader with the information they need to draw their own conclusions.
Where a source is open to interpretation or is disputed, editors should not assume a particular meaning. Interpretations can be discussed by reference to scholars. The editor should only seek to summarize and collect sources that accurately reflect the positions and dialogue concerning the article’s subject.  Articles should ''never'' end with an evaluation of the editor’s impression. In fact, the article should not have ending remarks at all, as they give a sense of finality and closure that discourages the reader from further research. The WikiIslam articles should aim only to provide the reader with the information they need to draw their own conclusions.


== Transliteration ==
==Transliteration==
If the transliterated word is not the subject of the article always link the first occurrence of the word to its own article when applicable. If you find a commonly transliterated word does not have its own article suggest or start one.
If the transliterated word is not the subject of the article always link the first occurrence of the word to its own article when applicable. If you find a commonly transliterated word does not have its own article suggest or start one.


=== Title ===
===Title===
For titles of transliterated words use the standardized transliteration as the title with the English translation in brackets next to it. Example: Jannah (Heaven)
For titles of transliterated words use the standardized transliteration as the title with the English translation in brackets next to it. Example: Jannah (Heaven)


=== Article ===
===Article===
If a word has a suitable English translation the first occurrence of the word should use the translation followed by brackets including the transliteration and the word in its original language. Example: dust (turabin تُرَابٍ) all following occurrences can use either the English translation (preferred) or the transliteration if necessary.  
If a word has a suitable English translation the first occurrence of the word should use the translation followed by brackets including the transliteration and the word in its original language. Example: dust (turabin تُرَابٍ) all following occurrences can use either the English translation (preferred) or the transliteration if necessary.  


recentchangescleanup, Reviewers, Administrators
148

edits

Navigation menu