You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.
This file contains invisible Unicode characters that may be processed differently from what appears below. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to reveal hidden characters.
This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
#lang pollen
◊ ( define - meta title "headings" )
◊ hanging - topic [ ( topic - from - metas metas ) ] { Fewer levels ;
subtler emphasis }
◊ em { Headings } present two problems: structural and typographic . Cure the structural problem and the typographic problem becomes simpler .
The main structural problem is that lawyers often use too many levels of headings . This leads to increasingly desperate attempts to make them visually distinct , usually with injudicious combinations of ◊ xref { bold or italic } , ◊ xref { underlining } , ◊ xref { point size } , ◊ xref { all caps } , and ◊ xref { first - line indents } . The result is trainwrecks like this:
◊ p [ #:style "padding-left:18rem;"]{◊u{◊em{◊strong{
iv . ) The Defendant Has
Sufficient Minimum Contacts with California . } } } }
Headings are signposts for readers that reveal the structure of your argument . Note that I didn ’ t say the structure of your ◊ em { document } . Headings that announce every topic , subtopic , minitopic , and microtopic are exhausting . If you write from an outline , that can be a good starting point for your headings , but don ’ t stop there — simplify it further .
Limit yourself to three levels of headings . Two is better . Readers should be able to orient themselves from the headings . With more than three levels , that task becomes hopelessly confusing .