Skip to content

refactor(templates): remove the classic cover-letter family#276

Merged
DemchaAV merged 1 commit into
2.0-devfrom
refactor/2.0-remove-classic-coverletter
Jun 30, 2026
Merged

refactor(templates): remove the classic cover-letter family#276
DemchaAV merged 1 commit into
2.0-devfrom
refactor/2.0-remove-classic-coverletter

Conversation

@DemchaAV

Copy link
Copy Markdown
Owner

Why

The Gen-2 cover-letter stack (coverletter.{presets,builder,spec,layouts} + data.coverletter) is superseded by the layered coverletter.v2 surface.

Removed before the classic CV family: each classic cover-letter preset has a {@link …cv.presets.X} "paired CV preset" Javadoc cross-ref that the javadoc gate would reject once cv.presets is deleted. CV does not reference cover-letter, so cover-letter-first leaves CV removal clean. (Cover-letter also needs no benchmark repoint — the benchmarks render CV/invoice/proposal.)

What

  • Delete the classic cover-letter packages + their tests + mock/CoverLetterMock. Keep + repoint coverletter/package-info at the v2 stack (dropped @Deprecated). All of coverletter.v2 is untouched (its presets are name-twins of the classic ones in a different package).
  • Strip the classic cover-letter helpers from TemplateTestSupport (coverLetter()/jobDetails(), only the deleted test called them) and ExampleDataFactory (sampleCoverLetter()/sampleCoverLetterDocument(); the v2 sample + sampleHeader() stay). Drop data.coverletter from the data package-info.
  • Remove an orphaned classic cover-letter layout snapshot (cover_letter_standard.json) that no test loads.

Tests

./mvnw verify javadoc:javadoc -pl . — 1553 tests, 0 failures, javadoc clean. Examples + benchmarks compile; examples-generation smoke (85) green, including the v2 cover-letter gallery. japicmp report-only on this line.

The Gen-2 cover-letter stack (coverletter.{presets,builder,spec,layouts} +
data.coverletter) is superseded by the layered coverletter.v2 surface. It is
removed before the classic CV family because each classic cover-letter preset
cross-references its paired cv.presets preset in Javadoc, which the javadoc
gate would reject once cv.presets is gone; CV does not reference cover-letter.

Delete the classic cover-letter packages, their tests, and the CoverLetterMock
fixture; repoint the cover-letter package-info at the v2 stack. Strip the
classic cover-letter helpers from TemplateTestSupport and ExampleDataFactory
(the v2 sample and sampleHeader stay) and the data.coverletter entry from the
data package-info. Also drop an orphaned classic cover-letter layout snapshot
that no test loads.

Tests: ./mvnw verify javadoc:javadoc -pl . — 1553 tests, 0 failures, javadoc
clean; examples + benchmarks compile; examples-generation smoke (85) green,
including the v2 cover-letter gallery.
@DemchaAV DemchaAV merged commit 02406d0 into 2.0-dev Jun 30, 2026
11 checks passed
@DemchaAV DemchaAV deleted the refactor/2.0-remove-classic-coverletter branch June 30, 2026 22:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant