WikiIslam:Structure: Difference between revisions

no edit summary
mNo edit summary
No edit summary
Line 1: Line 1:
[[File:Lead Image.png|thumb|The Lead Media is the first image seen when opening an article. It should appear on the right-hand side of the lead text, before the table of contents. It should be entered before any text as to align with the top row of the lead paragraph.]]The '''Structure''' of an article concerns the organization of sections and media. Better structure allows the reader to navigate the page easier and feels more intuitive. The structure should also seek to give maintain cohesiveness throughout the wiki. This aims to give the reader a better experience by using a predictable layout. WikiIslam generally adopts an encyclopedic format (e.g. [[72 Virgins]]), but can also include table/list formatted articles (e.g. [[The Timeline of Muhammad]]). All articles can be adjusted to keep the flow and intuitive feel of the article.
[[File:Lead Image.png|thumb|The Lead Media is the first image seen when opening an article. It should appear on the right-hand side of the lead text, before the table of contents. It should be entered before any text as to align with the top row of the lead paragraph.]]The '''Structure''' of an article concerns the organization of sections and media. Better structure allows the reader to navigate the page easier and feels more intuitive. The structure should also seek to give maintain cohesiveness throughout the wiki. This aims to give the reader a better experience by using a predictable layout. WikiIslam employs an encyclopedic format for all articles. All articles can be adjusted to keep the flow and intuitive feel of the article, deviating from these rules where necessary, however such deviations should be deliberate and rare.


==Lead==
==Lead==
Line 5: Line 5:


===First Paragraph===
===First Paragraph===
The first sentence should tell the reader what or who the subject is. If possible the page title should be the subject and if the subject is definable then the first sentence should be the definition. The first sentence should have the subject’s name in bold for the first occurrence and should not be linked. The rest of the paragraph should aim to answer the questions “Who, What, Where, When, and Why” that have not already been answered in the first sentence. Remember to only use simple
The first sentence should tell the reader what or who the subject is. If possible the page title should be the subject and if the subject is definable then the first sentence should be the definition. The first sentence should have the subject’s name in bold for the first occurrence and should not be linked. The rest of the paragraph should aim to answer the questions “Who, What, Where, When, and Why” that have not already been answered in the first sentence.


Here is a good example from the page on [[Muhammad ibn Abdullah|Muhammad]]:
Here is a good example from the page on [[Muhammad ibn Abdullah|Muhammad]]:
Line 16: Line 16:


===Sections===
===Sections===
There are no compulsory sections that are expected in the article or in which particular order they should be. However there are some commonly recurring sections. Articles will cover fast amounts of subjects and each article will be different. We recommend that you use your best judgement to order the article specific sections by relevance. If illustrating a biographical account of someone’s life, try to keep these sections in chronological unless there is critical information that should come first.
There are no compulsory sections that are expected in the article or in which particular order they should be. However there are some commonly recurring sections. Articles will cover fast amounts of subjects and each article will be different. We recommend that the editor use your best judgement to order the article specific sections by relevance. If illustrating a biographical account of someone’s life, try to keep these sections in chronological unless there is critical information that should come first.


Avoid one-sentence paragraphs as they inhibit the flow of the article. In the same vein, also avoid exceedingly long paragraphs that become hard to read. Conversely, short paragraphs usually do not warrant their own sections, tag it along another section where it fits, or if relevant enough add more to the new section.
Avoid one-sentence paragraphs as they inhibit the flow of the article. In the same vein, also avoid exceedingly long paragraphs that become hard to read. Conversely, short paragraphs usually do not warrant their own sections, tag it along another section where it fits, or if relevant enough add more to the new section.


Always consider the trade off between length and readability. For sections that are not as relevant to the subject of the article it may not be necessary to go into exhaustive detail (such as referencing multiple hadiths that say the same thing). If this is a topic worth such attention consider making a page of its own. Some subjects may naturally require more extensive coverage than others.
Always consider the trade off between length and readability. For sections that are not as relevant to the subject of the article it may not be necessary to go into exhaustive detail (such as referencing multiple hadiths that say the same thing). If this is a topic worth such attention consider making a page of its own. Some subjects may naturally require more extensive coverage than others. Sections which become overly long should be considered for articles of their own.  


===Text Quote===
===Text Quote===
Editors, recentchangescleanup, Reviewers
4,682

edits