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.
pollen-tfl/headings.html.pm

18 lines
1.3 KiB
Perl

#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 didnt 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 dont stop theresimplify 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.