Plain English - Organise: Difference between revisions

no edit summary
No edit summary
No edit summary
 
Line 33: Line 33:
:::::(1) '''Level 7''': Lorem ipsum}}
:::::(1) '''Level 7''': Lorem ipsum}}
*'''Optimise the number of levels''': Unless you are writing a monster document, you should not need to get anywhere near 7 sub-clause levels. If you do, this is a fair sign your logic is over-engineered. Don’t just collapse sub-paragraphs to reduce the number of sub-levels: rewrite the logic of the paragraph so you don’t need so many sub-levels.<ref>See: [[Semantic structure]].</ref>
*'''Optimise the number of levels''': Unless you are writing a monster document, you should not need to get anywhere near 7 sub-clause levels. If you do, this is a fair sign your logic is over-engineered. Don’t just collapse sub-paragraphs to reduce the number of sub-levels: rewrite the logic of the paragraph so you don’t need so many sub-levels.<ref>See: [[Semantic structure]].</ref>
*'''Indent''': Always use “nested” indents — like modern computer code — as it effortlessly reveals structure, creates white space and allows, er, room for manuscript markup.  
*'''Indent''': Always use “nested” indents — like modern computer code — as it effortlessly reveals structure, creates white space and allows, er, room for [[Mark-up|manuscript markup]].  
*'''[[Fingerpost|Fingerposts]]''': Include descriptive headings and a brief “fingerpost” for each sub-clause: the clearer the organisational layout is the better.
*'''[[Fingerpost|Fingerposts]]''': Include descriptive headings and a brief “fingerpost” for each sub-clause: the clearer the organisational layout is the better.
=== Formatting ===
=== Formatting ===