javaevolved · Copilot · Jul 8, 2026 · Jul 8, 2026
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
@@ -10,6 +10,8 @@ on:
       - 'site/**'
       - 'html-generators/generateog.java'
       - 'html-generators/og/**'
+      - 'html-generators/tags.properties'
+      - 'html-generators/categories.properties'
   workflow_run:
     workflows: ['Build Generator JARs']
     types: [completed]
@@ -53,7 +55,7 @@ jobs:
 
             NEEDS_GENERATE=false
 
-            if echo "$CHANGED" | grep -qE '^(content/|translations/|templates/)'; then
+            if echo "$CHANGED" | grep -qE '^(content/|translations/|templates/|html-generators/tags\.properties|html-generators/categories\.properties)'; then
               NEEDS_GENERATE=true
             fi
 

diff --git a/.gitignore b/.gitignore
@@ -11,6 +11,9 @@ site/security/*.html
 site/tooling/*.html
 site/enterprise/*.html
 
+# Generated topic pages (built by html-generators/)
+site/topics/*.html
+
 # Generated aggregate file (built from individual JSON sources by html-generators/)
 site/data/snippets.json
 

diff --git a/content/collections/collectors-teeing.yaml b/content/collections/collectors-teeing.yaml
@@ -46,6 +46,9 @@ related:
 - "collections/copying-collections-immutably"
 - "collections/unmodifiable-collectors"
 - "collections/stream-toarray-typed"
+tags:
+- streams
+- collectors
 docs:
 - title: "Collectors.teeing()"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/stream/Collectors.html#teeing(java.util.stream.Collector,java.util.stream.Collector,java.util.function.BiFunction)"
diff --git a/content/collections/copying-collections-immutably.yaml b/content/collections/copying-collections-immutably.yaml
@@ -40,6 +40,8 @@ related:
 - "collections/immutable-set-creation"
 - "collections/map-entry-factory"
 - "collections/immutable-list-creation"
+tags:
+- collections
 docs:
 - title: "List.copyOf()"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/List.html#copyOf(java.util.Collection)"
diff --git a/content/collections/immutable-list-creation.yaml b/content/collections/immutable-list-creation.yaml
@@ -42,6 +42,8 @@ related:
 - "collections/immutable-map-creation"
 - "collections/immutable-set-creation"
 - "collections/sequenced-collections"
+tags:
+- collections
 docs:
 - title: "List.of()"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/List.html#of()"

diff --git a/content/collections/immutable-map-creation.yaml b/content/collections/immutable-map-creation.yaml
@@ -40,6 +40,8 @@ related:
 - "collections/copying-collections-immutably"
 - "collections/sequenced-collections"
 - "streams/stream-tolist"
+tags:
+- collections
 docs:
 - title: "Map.of()"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/Map.html#of()"

diff --git a/content/collections/immutable-set-creation.yaml b/content/collections/immutable-set-creation.yaml
@@ -41,6 +41,8 @@ related:
 - "collections/copying-collections-immutably"
 - "collections/collectors-teeing"
 - "streams/stream-tolist"
+tags:
+- collections
 docs:
 - title: "Set.of()"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/Set.html#of()"

diff --git a/content/collections/map-entry-factory.yaml b/content/collections/map-entry-factory.yaml
@@ -38,6 +38,8 @@ related:
 - "collections/sequenced-collections"
 - "collections/immutable-map-creation"
 - "collections/immutable-list-creation"
+tags:
+- collections
 docs:
 - title: "Map.entry()"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/Map.html#entry(K,V)"
diff --git a/content/collections/reverse-list-iteration.yaml b/content/collections/reverse-list-iteration.yaml
@@ -43,6 +43,8 @@ related:
 - "collections/sequenced-collections"
 - "collections/immutable-list-creation"
 - "streams/stream-tolist"
+tags:
+- collections
 docs:
 - title: "SequencedCollection (Java 21)"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/SequencedCollection.html"

diff --git a/content/collections/sequenced-collections.yaml b/content/collections/sequenced-collections.yaml
@@ -42,6 +42,8 @@ related:
 - "collections/collectors-teeing"
 - "collections/immutable-set-creation"
 - "collections/immutable-map-creation"
+tags:
+- collections
 docs:
 - title: "Sequenced Collections (JEP 431)"
   href: "https://openjdk.org/jeps/431"

diff --git a/content/collections/stream-toarray-typed.yaml b/content/collections/stream-toarray-typed.yaml
@@ -46,6 +46,9 @@ related:
 - "collections/collectors-teeing"
 - "collections/map-entry-factory"
 - "collections/immutable-set-creation"
+tags:
+- streams
+- collections
 docs:
 - title: "Stream.toArray()"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/stream/Stream.html#toArray(java.util.function.IntFunction)"
diff --git a/content/collections/unmodifiable-collectors.yaml b/content/collections/unmodifiable-collectors.yaml
@@ -41,6 +41,9 @@ related:
 - "collections/immutable-map-creation"
 - "collections/immutable-set-creation"
 - "streams/stream-tolist"
+tags:
+- streams
+- collections
 docs:
 - title: "Stream.toList()"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/stream/Stream.html#toList()"

diff --git a/content/concurrency/completablefuture-chaining.yaml b/content/concurrency/completablefuture-chaining.yaml
@@ -43,6 +43,9 @@ related:
 - "concurrency/stable-values"
 - "concurrency/scoped-values"
 - "concurrency/structured-concurrency"
+tags:
+- concurrency
+- async
 docs:
 - title: "CompletableFuture"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/CompletableFuture.html"
diff --git a/content/concurrency/concurrent-http-virtual.yaml b/content/concurrency/concurrent-http-virtual.yaml
@@ -51,6 +51,9 @@ related:
 - "concurrency/structured-concurrency"
 - "concurrency/stable-values"
 - "concurrency/lock-free-lazy-init"
+tags:
+- virtual-threads
+- concurrency
 docs:
 - title: "Virtual Threads (JEP 444)"
   href: "https://openjdk.org/jeps/444"

diff --git a/content/concurrency/executor-try-with-resources.yaml b/content/concurrency/executor-try-with-resources.yaml
@@ -48,6 +48,9 @@ related:
 - "concurrency/completablefuture-chaining"
 - "concurrency/virtual-threads"
 - "concurrency/thread-sleep-duration"
+tags:
+- virtual-threads
+- concurrency
 docs:
 - title: "ExecutorService"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/ExecutorService.html"
diff --git a/content/concurrency/lock-free-lazy-init.yaml b/content/concurrency/lock-free-lazy-init.yaml
@@ -55,6 +55,8 @@ related:
 - "concurrency/virtual-threads"
 - "concurrency/structured-concurrency"
 - "concurrency/scoped-values"
+tags:
+- concurrency
 docs:
 - title: "StableValue (JEP 502)"
   href: "https://openjdk.org/jeps/502"

diff --git a/content/concurrency/process-api.yaml b/content/concurrency/process-api.yaml
@@ -46,6 +46,8 @@ related:
 - "concurrency/scoped-values"
 - "concurrency/concurrent-http-virtual"
 - "concurrency/completablefuture-chaining"
+tags:
+- concurrency
 docs:
 - title: "ProcessHandle"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/ProcessHandle.html"

diff --git a/content/concurrency/scoped-values.yaml b/content/concurrency/scoped-values.yaml
@@ -48,6 +48,9 @@ related:
 - "concurrency/virtual-threads"
 - "concurrency/structured-concurrency"
 - "concurrency/stable-values"
+tags:
+- concurrency
+- virtual-threads
 docs:
 - title: "Scoped Values (JEP 487)"
   href: "https://openjdk.org/jeps/487"

diff --git a/content/concurrency/stable-values.yaml b/content/concurrency/stable-values.yaml
@@ -50,6 +50,8 @@ related:
 - "concurrency/virtual-threads"
 - "concurrency/structured-concurrency"
 - "concurrency/scoped-values"
+tags:
+- concurrency
 docs:
 - title: "Stable Values (JEP 502)"
   href: "https://openjdk.org/jeps/502"

diff --git a/content/concurrency/structured-concurrency.yaml b/content/concurrency/structured-concurrency.yaml
@@ -48,6 +48,9 @@ related:
 - "concurrency/virtual-threads"
 - "concurrency/scoped-values"
 - "concurrency/stable-values"
+tags:
+- concurrency
+- virtual-threads
 docs:
 - title: "Structured Concurrency (JEP 499)"
   href: "https://openjdk.org/jeps/499"

diff --git a/content/concurrency/thread-sleep-duration.yaml b/content/concurrency/thread-sleep-duration.yaml
@@ -45,6 +45,8 @@ related:
 - "concurrency/stable-values"
 - "concurrency/concurrent-http-virtual"
 - "concurrency/completablefuture-chaining"
+tags:
+- concurrency
 docs:
 - title: "Thread.sleep(Duration)"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/Thread.html#sleep(java.time.Duration)"
diff --git a/content/concurrency/virtual-threads.yaml b/content/concurrency/virtual-threads.yaml
@@ -42,6 +42,9 @@ related:
 - "concurrency/thread-sleep-duration"
 - "concurrency/scoped-values"
 - "concurrency/completablefuture-chaining"
+tags:
+- virtual-threads
+- concurrency
 docs:
 - title: "Virtual Threads (JEP 444)"
   href: "https://openjdk.org/jeps/444"

diff --git a/content/datetime/date-formatting.yaml b/content/datetime/date-formatting.yaml
@@ -45,6 +45,8 @@ related:
 - "datetime/instant-precision"
 - "datetime/java-time-basics"
 - "datetime/hex-format"
+tags:
+- datetime
 docs:
 - title: "DateTimeFormatter"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/time/format/DateTimeFormatter.html"
diff --git a/content/datetime/duration-and-period.yaml b/content/datetime/duration-and-period.yaml
@@ -46,6 +46,8 @@ related:
 - "datetime/java-time-basics"
 - "datetime/date-formatting"
 - "datetime/math-clamp"
+tags:
+- datetime
 docs:
 - title: "Duration"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/time/Duration.html"

diff --git a/content/datetime/hex-format.yaml b/content/datetime/hex-format.yaml
@@ -46,6 +46,9 @@ related:
 - "datetime/date-formatting"
 - "datetime/instant-precision"
 - "datetime/duration-and-period"
+tags:
+- strings
+- formatting
 docs:
 - title: "HexFormat"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/HexFormat.html"
diff --git a/content/datetime/instant-precision.yaml b/content/datetime/instant-precision.yaml
@@ -42,6 +42,8 @@ related:
 - "datetime/hex-format"
 - "datetime/java-time-basics"
 - "datetime/duration-and-period"
+tags:
+- datetime
 docs:
 - title: "Instant"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/time/Instant.html"

diff --git a/content/datetime/java-time-basics.yaml b/content/datetime/java-time-basics.yaml
@@ -44,6 +44,8 @@ related:
 - "datetime/instant-precision"
 - "datetime/duration-and-period"
 - "datetime/date-formatting"
+tags:
+- datetime
 docs:
 - title: "LocalDate"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/time/LocalDate.html"

diff --git a/content/datetime/math-clamp.yaml b/content/datetime/math-clamp.yaml
@@ -41,6 +41,8 @@ related:
 - "datetime/instant-precision"
 - "datetime/hex-format"
 - "datetime/duration-and-period"
+tags:
+- math
 docs:
 - title: "Math.clamp()"
   href: "https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/Math.html#clamp(long,int,int)"
diff --git a/content/enterprise/ejb-timer-vs-jakarta-scheduler.yaml b/content/enterprise/ejb-timer-vs-jakarta-scheduler.yaml
@@ -74,6 +74,9 @@ related:
 - "enterprise/ejb-vs-cdi"
 - "concurrency/virtual-threads"
 - "concurrency/executor-try-with-resources"
+tags:
+- enterprise
+- jakarta
 docs:
 - title: "Jakarta Concurrency Specification"
   href: "https://jakarta.ee/specifications/concurrency/"

diff --git a/content/enterprise/ejb-vs-cdi.yaml b/content/enterprise/ejb-vs-cdi.yaml
@@ -59,6 +59,9 @@ related:
 - "enterprise/servlet-vs-jaxrs"
 - "enterprise/jdbc-vs-jpa"
 - "language/records-for-data-classes"
+tags:
+- enterprise
+- jakarta
 docs:
 - title: "Jakarta CDI Specification"
   href: "https://jakarta.ee/specifications/cdi/"

diff --git a/content/enterprise/jdbc-resultset-vs-jpa-criteria.yaml b/content/enterprise/jdbc-resultset-vs-jpa-criteria.yaml
@@ -70,6 +70,10 @@ related:
 - "enterprise/jdbc-vs-jpa"
 - "enterprise/jpa-vs-jakarta-data"
 - "enterprise/manual-transaction-vs-declarative"
+tags:
+- enterprise
+- persistence
+- jpa
 docs:
 - title: "Jakarta Persistence Specification"
   href: "https://jakarta.ee/specifications/persistence/"

diff --git a/content/enterprise/jdbc-vs-jooq.yaml b/content/enterprise/jdbc-vs-jooq.yaml
@@ -66,6 +66,9 @@ related:
 - "enterprise/jdbc-vs-jpa"
 - "enterprise/jdbc-resultset-vs-jpa-criteria"
 - "enterprise/manual-transaction-vs-declarative"
+tags:
+- enterprise
+- persistence
 docs:
 - title: "jOOQ — Getting Started"
   href: "https://www.jooq.org/doc/latest/manual/getting-started/"

diff --git a/content/enterprise/jdbc-vs-jpa.yaml b/content/enterprise/jdbc-vs-jpa.yaml
@@ -63,6 +63,10 @@ related:
 - "enterprise/servlet-vs-jaxrs"
 - "enterprise/ejb-vs-cdi"
 - "io/try-with-resources-effectively-final"
+tags:
+- enterprise
+- persistence
+- jpa
 docs:
 - title: "Jakarta Persistence Specification"
   href: "https://jakarta.ee/specifications/persistence/"

diff --git a/content/enterprise/jndi-lookup-vs-cdi-injection.yaml b/content/enterprise/jndi-lookup-vs-cdi-injection.yaml
@@ -68,6 +68,9 @@ related:
 - "enterprise/ejb-vs-cdi"
 - "enterprise/jdbc-vs-jpa"
 - "enterprise/singleton-ejb-vs-cdi-application-scoped"
+tags:
+- enterprise
+- jakarta
 docs:
 - title: "Jakarta CDI Specification"
   href: "https://jakarta.ee/specifications/cdi/"

diff --git a/content/enterprise/jpa-vs-jakarta-data.yaml b/content/enterprise/jpa-vs-jakarta-data.yaml
@@ -62,6 +62,10 @@ related:
 - "enterprise/jdbc-vs-jpa"
 - "enterprise/ejb-vs-cdi"
 - "enterprise/servlet-vs-jaxrs"
+tags:
+- enterprise
+- persistence
+- jpa
 docs:
 - title: "Jakarta Data 1.0 Specification"
   href: "https://jakarta.ee/specifications/data/1.0/"

diff --git a/content/enterprise/jsf-managed-bean-vs-cdi-named.yaml b/content/enterprise/jsf-managed-bean-vs-cdi-named.yaml
@@ -68,6 +68,9 @@ related:
 - "enterprise/ejb-vs-cdi"
 - "enterprise/jndi-lookup-vs-cdi-injection"
 - "enterprise/servlet-vs-jaxrs"
+tags:
+- enterprise
+- jakarta
 docs:
 - title: "Jakarta Faces Specification"
   href: "https://jakarta.ee/specifications/faces/"

diff --git a/content/enterprise/manual-transaction-vs-declarative.yaml b/content/enterprise/manual-transaction-vs-declarative.yaml
@@ -70,6 +70,9 @@ related:
 - "enterprise/ejb-vs-cdi"
 - "enterprise/jdbc-vs-jpa"
 - "enterprise/jpa-vs-jakarta-data"
+tags:
+- enterprise
+- persistence
 docs:
 - title: "Jakarta Transactions Specification"
   href: "https://jakarta.ee/specifications/transactions/"

diff --git a/content/enterprise/mdb-vs-reactive-messaging.yaml b/content/enterprise/mdb-vs-reactive-messaging.yaml
@@ -64,6 +64,9 @@ related:
 - "enterprise/ejb-vs-cdi"
 - "concurrency/structured-concurrency"
 - "concurrency/virtual-threads"
+tags:
+- enterprise
+- reactive
 docs:
 - title: "MicroProfile Reactive Messaging Specification"
   href: "https://download.eclipse.org/microprofile/microprofile-reactive-messaging-3.0/microprofile-reactive-messaging-spec-3.0.html"

diff --git a/content/enterprise/servlet-vs-jaxrs.yaml b/content/enterprise/servlet-vs-jaxrs.yaml
@@ -58,6 +58,9 @@ related:
 - "enterprise/ejb-vs-cdi"
 - "enterprise/jdbc-vs-jpa"
 - "io/http-client"
+tags:
+- enterprise
+- rest
 docs:
 - title: "Jakarta RESTful Web Services Specification"
   href: "https://jakarta.ee/specifications/restful-ws/"

diff --git a/content/enterprise/singleton-ejb-vs-cdi-application-scoped.yaml b/content/enterprise/singleton-ejb-vs-cdi-application-scoped.yaml
@@ -78,6 +78,9 @@ related:
 - "enterprise/ejb-vs-cdi"
 - "enterprise/jndi-lookup-vs-cdi-injection"
 - "concurrency/lock-free-lazy-init"
+tags:
+- enterprise
+- jakarta
 docs:
 - title: "Jakarta CDI Specification"
   href: "https://jakarta.ee/specifications/cdi/"