Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
help:advanced_syntax [2020/02/14 15:32] icnahelp:advanced_syntax [2020/02/17 14:30] (current) – [Copyright] icna
Line 3: Line 3:
  
 ===== Layout ===== ===== Layout =====
-Good articles start with introductions, continue with a clear structure, and end with standard appendices such as references and related articles.Good articles start with a brief lead section introducing the topic. The lead section should come above the first header. There is no need to add a heading called "introduction". Sometimes, the first section after the lead is a broad summary of the topic, and can be called "Overview", although more specific section titles and structures are generally preferred.+Good articles start with a brief lead section introducing the topic, continue with a clear structure, and end with standard appendices such as references and related articles. The lead section should come above the first header. There is no need to add a heading called "introduction". Sometimes, the first section after the lead is a broad summary of the topic, and can be called "Overview", although more specific section titles and structures are generally preferred.
  
 ==== Paragraphs ==== ==== Paragraphs ====
Line 14: Line 14:
 One-sentence paragraphs are unusually emphatic, and should be used sparingly. Articles should rarely, if ever, consist solely of such paragraphs. One-sentence paragraphs are unusually emphatic, and should be used sparingly. Articles should rarely, if ever, consist solely of such paragraphs.
  
-Some paragraphs are really tables or lists in disguise. They should be rewritten as prose or converted to their unmasked form. [[wp>When to use tables]] and [[wp>Embedded list]] offer guidance on the proper use of these elements.+Some paragraphs are really tables or lists in disguise. They should be rewritten as prose or converted to their unmasked form. [[When to use tables]] and [[Embedded list]] offer guidance on the proper use of these elements.
  
 ==== Headings ==== ==== Headings ====
  
-Headings help clarify articles and create a structure shown in the table of contents. Headings are hierarchical. The article's title uses a level 1 heading, so you should start with a level 2 heading (==Heading==) and follow it with lower levels: ===Subheading===, ====Subsubheading====, and so forth. It is upto the author to decide whether the subtopics are so extensive that they should be kept on one page or moved to individual pages. Headings should not be Wikilinked.+Headings help clarify articles and create a structure shown in the table of contents. Headings are hierarchical. The article's title uses a level 1 heading, so you should start with a level 2 heading (==Heading==) and follow it with lower levels: ===Subheading===, ====Subsubheading====, and so forth. It is upto the author to decide whether the subtopics are so extensive that they should be kept on one page or moved to individual pages. Headings should not be linked.
 ==== Images ==== ==== Images ====
 If the article can be illustrated with pictures, find an appropriate place to position these images, where they relate closely to text they illustrate. If there might be doubt, draw attention to the image in the text. If the article can be illustrated with pictures, find an appropriate place to position these images, where they relate closely to text they illustrate. If there might be doubt, draw attention to the image in the text.
  
  • help/advanced_syntax.1581694361.txt.gz
  • Last modified: 2020/02/14 15:32
  • by icna