fix(templates): correct 06 structure-block antipattern and 05 needspace scope (#183)

Both found by empirically re-running the /apply pipeline end-to-end:
06's Document Structure block still demonstrated itemize wrapped inside
lettercontent - the exact antipattern its own pitfall section forbids -
and following 05's needspace guidance at section level pushed an entire
Education block to a new page, costing a page instead of saving one.
framework_version: 05 -> 1.1.1, 06 -> 1.0.1.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Mads Lorentzen
2026-07-18 22:19:02 +02:00
committed by GitHub
co-authored by Claude Fable 5
parent de91a97fe8
commit 12717d2c12
2 changed files with 8 additions and 5 deletions
@@ -1,5 +1,5 @@
--- ---
framework_version: 1.1.0 framework_version: 1.1.1
--- ---
# CV Templates and Tailoring Guide # CV Templates and Tailoring Guide
@@ -171,6 +171,8 @@ Add `\needspace{5\baselineskip}` immediately before the problematic `\cventry`:
``` ```
Include `\usepackage{needspace}` in the preamble. Include `\usepackage{needspace}` in the preamble.
**Caveat - use `\needspace` before entries, never before `\section` headings.** A section-level `\needspace` pushes the entire section (heading plus content) to the next page whenever the request does not fit, stranding empty space above and typically *adding* a page instead of saving one. Apply it only to the individual `\cventry` that actually orphans, and only after a compile shows the orphan.
**Problem: one trailing section spills to page 3 (e.g., References alone on page 3)** **Problem: one trailing section spills to page 3 (e.g., References alone on page 3)**
Add `\enlargethispage{2-3\baselineskip}` before a late section (e.g., before `\section{Honors and Awards}`) to stretch page 2 by a few lines. This is the standard LaTeX rescue for near-miss overflows. Add `\enlargethispage{2-3\baselineskip}` before a late section (e.g., before `\section{Honors and Awards}`) to stretch page 2 by a few lines. This is the standard LaTeX rescue for near-miss overflows.
@@ -1,5 +1,5 @@
--- ---
framework_version: 1.0.0 framework_version: 1.0.1
--- ---
# Cover Letter Templates and Tailoring Guide # Cover Letter Templates and Tailoring Guide
@@ -88,15 +88,16 @@ The font wrapper is mandatory — if you just move `\begin{itemize}` outside `\l
\lettercontent{[Opening paragraph - role, connection to background, 2-3 sentences]} \lettercontent{[Opening paragraph - role, connection to background, 2-3 sentences]}
\lettercontent{[Body paragraph - most relevant experience, then bullet list] \lettercontent{[Body paragraph - most relevant experience, introducing the bullet list]}
{\raggedright\fontspec[Path = OpenFonts/fonts/raleway/]{Raleway-Medium}\fontsize{11pt}{13pt}\selectfont
\begin{itemize} \begin{itemize}
\item [Concrete achievement/skill 1] \item [Concrete achievement/skill 1]
\item [Concrete achievement/skill 2] \item [Concrete achievement/skill 2]
\item [Concrete achievement/skill 3] \item [Concrete achievement/skill 3]
\end{itemize} \end{itemize}\par}
[Connection to company - why this role, why this company specifically]} \lettercontent{[Connection to company - why this role, why this company specifically]}
\lettercontent{[Personal fit paragraph - behavioral strengths, team contribution, 2-3 sentences]} \lettercontent{[Personal fit paragraph - behavioral strengths, team contribution, 2-3 sentences]}