Skip to content

Add archived reference for Hexagonal Architecture JavaDoc - #191

Open
youngledo wants to merge 1 commit into
xmolecules:mainfrom
youngledo:docs/hexagonal-archive-link
Open

Add archived reference for Hexagonal Architecture JavaDoc#191
youngledo wants to merge 1 commit into
xmolecules:mainfrom
youngledo:docs/hexagonal-archive-link

Conversation

@youngledo

@youngledo youngledo commented Jun 26, 2026

Copy link
Copy Markdown

Summary

  • The live alistair.cockburn.us/hexagonal-architecture/ page no longer matches Cockburn's original article. Notably, the primary/secondary (driving/driven) ports and adapters distinction that this module encodes is absent from the current page.
  • This PR keeps the canonical link (still the authoritative pointer to the article) and adds an Internet Archive snapshot next to it — the snapshot preserves the version that actually contains the terminology jmolecules models. Each @see is annotated so readers can tell which is the canonical pointer and which is the version that matches the code.

Files changed

Six types under jmolecules-hexagonal-architecture get the same dual-link treatment:

  • Adapter
  • Application
  • Port
  • PrimaryAdapter
  • PrimaryPort
  • SecondaryPort

(SecondaryAdapter previously had no @see reference to the article, so it is not touched.)

Test plan

  • mvn -q -pl jmolecules-architecture/jmolecules-hexagonal-architecture javadoc:javadoc renders the new links cleanly.
  • Spot-check the generated Javadoc for one type (e.g. Port) to confirm both links render with their trailing description.

@youngledo
youngledo force-pushed the docs/hexagonal-archive-link branch from cdae442 to 83a0c89 Compare June 26, 2026 03:54
The live alistair.cockburn.us page no longer reflects Cockburn's original article, notably the primary/secondary (driving/driven) distinction that this module models.

Keep the live URL as the canonical pointer and add the Internet Archive snapshot as the version containing the terminology jmolecules encodes.
@youngledo
youngledo force-pushed the docs/hexagonal-archive-link branch from 83a0c89 to 115b4c7 Compare July 2, 2026 06:38
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