doc: updated docs for generics and updated roadmap

Signed-off-by: Frederic BIDON <fredbi@yahoo.com>

Author: fredbi

README.md

@@ -25,6 +25,7 @@ Main features:
 
 * zero external dependencies
 * opt-in dependencies for extra features (e.g. asserting YAML, colorized output)
+* assertions using generic types (see [a basic example][example-with-generics-url])
 * [searchable documentation][doc-url]
 
 ## Announcements
@@ -43,8 +44,15 @@ Design and exploration phase. Contributions and proposals are welcome.
 
 > **Recent news**
 > Fully refactored how assertions are generated and documented.
+> Fixed hangs & panics when using `spew`. Fuzzed `spew`.
+> Fixed go routine leaks with `EventuallyWithT` and co.
+> Added `Kind` & `NotKind`
+> Fix deterministic order of keys in diff
+> Fixed edge cases with `InDelta`, `InEpsilon`
+> Added opt-in support for colorized output
+> Introduced generics (round 1): 16 new type-safe assertions with generic types (added benchmark)
 >
-> Now on our way to apply more fixes, features and adopt generics. See [ROADMAP][roadmap].
+> See our [ROADMAP][roadmap].
 
 ## Import this library in your project
 
@@ -93,7 +101,7 @@ Becomes:
 
 ## Usage at go-openapi and go-swagger
 
-This fork now full replaces the original project for all go-openapi projects,
+This fork now fully replaces the original project for all go-openapi projects,
 thus reducing their dependencies footprint.
 
 Go-swagger will be adapted over Q1 2026.
@@ -161,6 +169,7 @@ Maintainers can cut a new release by either:
 <!-- Badges: documentation & support -->
 [doc-badge]: https://img.shields.io/badge/doc-site-blue?link=https%3A%2F%2Fgo-openapi.github.io%2Ftestify%2F
 [doc-url]: https://go-openapi.github.io/testify
+[example-with-generics-url]: https://go-openapi.github.io/testify#usage-with-generics
 [godoc-badge]: https://pkg.go.dev/badge/github.com/go-openapi/testify
 [godoc-url]: http://pkg.go.dev/github.com/go-openapi/testify
 [slack-logo]: https://a.slack-edge.com/e6a93c1/img/icons/favicon-32.png

codegen/internal/generator/templates/doc_index.md.gotmpl

@@ -26,6 +26,7 @@ with all documented exported variants documented in a more concise form than the
 ## Domains
 
 The `testify` API is organized in {{ .RefCount }} domains shown below.
+Each domain contains assertions regrouped by their use case (e.g. http, json, error).
 
 {{ print "{{" }}< children type="card" description="true" >{{ print "}}" }}
 

codegen/internal/generator/templates/doc_page.md.gotmpl

@@ -41,7 +41,7 @@ Generic assertions are marked with a {{ print "{{" }}% icon icon="star" color=or
   {{- range .Functions }}{{/* functions in internal/assertions annotated with "domain:" */}}
     {{- if or (not .IsGeneric) ($enableGenerics) }}
       {{- if and (not .IsHelper) (not .IsConstructor) }}
-- [{{ .GenericName }}](#{{ slugize .GenericName }}) | {{ if .IsGeneric}}star | orange {{ else }}angles-right{{ end }}
+- [{{ .GenericName }}](#{{ slugize .GenericName }}) | {{ if .IsGeneric}}star | orange{{ else }}angles-right{{ end }}
       {{- end }}
     {{- end }}
   {{- end }}

docs/doc-site/_index.md

@@ -1,19 +1,17 @@
 ---
 title: "Testify v2"
 type: home
-description: 'Go testing assertions for the rest of us'
+description: 'The v2 our test wanted'
 weight: 1
 ---
 
-**Go testing assertions for the rest of us**
-
 {{% notice info %}}
 This is the home of `github.com/go-openapi/testify/v2`, an active, opinionated fork of `github.com/stretchr/testify`.
 {{% /notice %}}
 
 ## Testify v2 - The v2 our tests wanted
 
-A set of `go` packages that provide tools for testifying that your code behaves as you intended.
+A set of `go` packages that provide tools for _testifying_ (verifying) that your code behaves as you intended.
 
 This is the go-openapi fork of the great [testify](https://github.com/stretchr/testify) package.
 
@@ -44,7 +42,9 @@ APIs that became bloated over a decade or so, uncontrolled dependencies, difficu
 breaking changes, conflicting demands from users etc.
 {{% /notice %}}
 
-More about our motivations in the project's [README](README.md).
+More about our motivations in the project's [README](README.md#motivation).
+
+You might also be curious about our [ROADMAP](project/maintainers/ROADMAP.md).
 
 ### Getting started
 
@@ -86,6 +86,7 @@ To use this package in your projects:
 ```go
     import (
         "testing"
+
         "github.com/go-openapi/testify/v2/require"
     )
     ...
@@ -101,6 +102,33 @@ To use this package in your projects:
 {{% /card %}}
 {{< /cards >}}
 
+### Usage with generics
+
+Assertion functions that support go generic types are suffixed with `T` (for "Type safety").
+A formatted variant suffixed with `Tf` is also exposed.
+
+Obviously, the `Assertion` type cannot be extended with generic methods, as of `go1.25`.
+
+{{% card title="InDeltaT" %}}
+```go
+    import (
+        "testing"
+
+        "github.com/go-openapi/testify/v2/require"
+    )
+    ...
+    
+    const (
+        expected = 1.00
+        delta = 1E-6
+    )
+    var input = 1.01
+
+	result := someComplexComputation(input)
+    require.InDeltaT(t, expected, input, delta)
+```
+{{% /card %}}
+
 ## Licensing
 
 `SPDX-FileCopyrightText: Copyright 2025 go-swagger maintainers`

docs/doc-site/api/_index.md

@@ -6,7 +6,7 @@ description: |
 
   Find the assertion function you need for your data.
 weight: 1
-modified: 2026-01-11
+modified: 2026-01-18
 ---
 
 **Go testing assertions for the rest of us**
@@ -26,28 +26,29 @@ with all documented exported variants documented in a more concise form than the
 ## Domains
 
 The `testify` API is organized in 18 domains shown below.
+Each domain contains assertions regrouped by their use case (e.g. http, json, error).
 
 {{< children type="card" description="true" >}}
 
 ---
 
-- [Boolean](./boolean.md) - Asserting Boolean Values (2)
-- [Collection](./collection.md) - Asserting Slices And Maps (7)
-- [Comparison](./comparison.md) - Comparing Ordered Values (6)
+- [Boolean](./boolean.md) - Asserting Boolean Values (4)
+- [Collection](./collection.md) - Asserting Slices And Maps (9)
+- [Comparison](./comparison.md) - Comparing Ordered Values (12)
 - [Condition](./condition.md) - Expressing Assertions Using Conditions (4)
 - [Equality](./equality.md) - Asserting Two Things Are Equal (12)
 - [Error](./error.md) - Asserting Errors (8)
 - [File](./file.md) - Asserting OS Files (6)
 - [Http](./http.md) - Asserting HTTP Response And Body (7)
-- [Json](./json.md) - Asserting JSON Documents (2)
-- [Number](./number.md) - Asserting Numbers (5)
+- [Json](./json.md) - Asserting JSON Documents (3)
+- [Number](./number.md) - Asserting Numbers (7)
 - [Ordering](./ordering.md) - Asserting How Collections Are Ordered (4)
 - [Panic](./panic.md) - Asserting A Panic Behavior (4)
-- [String](./string.md) - Asserting Strings (2)
+- [String](./string.md) - Asserting Strings (4)
 - [Testing](./testing.md) - Mimicks Methods From The Testing Standard Library (2)
 - [Time](./time.md) - Asserting Times And Durations (2)
 - [Type](./type.md) - Asserting Types Rather Than Values (8)
-- [Yaml](./yaml.md) - Asserting Yaml Documents (1)
+- [Yaml](./yaml.md) - Asserting Yaml Documents (3)
 - [Common](./common.md) - Other Uncategorized Helpers (4)
 
 ---
@@ -66,5 +67,5 @@ SPDX-License-Identifier: Apache-2.0
 
 Document generated by github.com/go-openapi/testify/codegen/v2 DO NOT EDIT.
 
-Generated on 2026-01-11 (version ca82e58) using codegen version v2.1.9-0.20260111184010-ca82e58db12c+dirty [sha: ca82e58db12cbb61bfcae58c3684b3add9599d10]
+Generated on 2026-01-18 (version e12affe) using codegen version v2.1.9-0.20260118112101-e12affef2419+dirty [sha: e12affef24198e72ee13eb6d25018d2c3232629f]
 -->

docs/doc-site/api/boolean.md

@@ -1,15 +1,19 @@
 ---
 title: "Boolean"
 description: "Asserting Boolean Values"
-modified: 2026-01-11
+modified: 2026-01-18
 weight: 1
 domains:
   - "boolean"
 keywords:
   - "False"
   - "Falsef"
+  - "FalseT"
+  - "FalseTf"
   - "True"
   - "Truef"
+  - "TrueT"
+  - "TrueTf"
 ---
 
 Asserting Boolean Values
@@ -21,9 +25,17 @@ Asserting Boolean Values
 
 _All links point to <https://pkg.go.dev/github.com/go-openapi/testify/v2>_
 
-This domain exposes 2 functionalities.
+This domain exposes 4 functionalities.
+Generic assertions are marked with a {{% icon icon="star" color=orange %}}
 
-### False
+```tree
+- [False](#false) | angles-right
+- [FalseT[B Boolean]](#falsetb-boolean) | star | orange
+- [True](#true) | angles-right
+- [TrueT[B Boolean]](#truetb-boolean) | star | orange
+```
+
+### False{#false}
 
 False asserts that the specified value is false.
 
@@ -66,11 +78,56 @@ False asserts that the specified value is false.
 |--|--| 
 | [`assertions.False(t T, value bool, msgAndArgs ...any) bool`](https://pkg.go.dev/github.com/go-openapi/testify/v2/internal/assertions#False) | internal implementation |
 
-**Source:** [github.com/go-openapi/testify/v2/internal/assertions#False](https://github.com/go-openapi/testify/blob/master/internal/assertions/boolean.go#L38)
+**Source:** [github.com/go-openapi/testify/v2/internal/assertions#False](https://github.com/go-openapi/testify/blob/master/internal/assertions/boolean.go#L63)
+{{% /tab %}}
+{{< /tabs >}}
+
+### FalseT[B Boolean] {{% icon icon="star" color=orange %}}{#falsetb-boolean}
+
+FalseT asserts that the specified value is false.
+
+{{% expand title="Examples" %}}
+{{< tabs >}}
+{{% tab title="Usage" %}}
+```go
+	 type B bool
+	 var b B = true
+		assertions.FalseT(t, b)
+```
+{{< /tab >}}
+{{% tab title="Examples" %}}
+```go
+	success: 1 == 0
+	failure: 1 == 1
+```
+{{< /tab >}}
+{{< /tabs >}}
+{{% /expand %}}
+
+{{< tabs >}}
+{{% tab title="assert" style="secondary" %}}
+| Signature | Usage |
+|--|--|
+| [`assert.FalseT[B Boolean](t T, value B, msgAndArgs ...any) bool`](https://pkg.go.dev/github.com/go-openapi/testify/v2/assert#FalseT) | package-level function |
+| [`assert.FalseTf[B Boolean](t T, value B, msg string, args ...any) bool`](https://pkg.go.dev/github.com/go-openapi/testify/v2/assert#FalseTf) | formatted variant |
+{{% /tab %}}
+{{% tab title="require" style="secondary" %}}
+| Signature | Usage |
+|--|--|
+| [`require.FalseT[B Boolean](t T, value B, msgAndArgs ...any) bool`](https://pkg.go.dev/github.com/go-openapi/testify/v2/require#FalseT) | package-level function |
+| [`require.FalseTf[B Boolean](t T, value B, msg string, args ...any) bool`](https://pkg.go.dev/github.com/go-openapi/testify/v2/require#FalseTf) | formatted variant |
+{{% /tab %}}
+
+{{% tab title="internal" style="accent" icon="wrench" %}}
+| Signature | Usage |
+|--|--| 
+| [`assertions.FalseT(t T, value B, msgAndArgs ...any) bool`](https://pkg.go.dev/github.com/go-openapi/testify/v2/internal/assertions#FalseT) | internal implementation |
+
+**Source:** [github.com/go-openapi/testify/v2/internal/assertions#FalseT](https://github.com/go-openapi/testify/blob/master/internal/assertions/boolean.go#L88)
 {{% /tab %}}
 {{< /tabs >}}
 
-### True
+### True{#true}
 
 True asserts that the specified value is true.
 
@@ -117,6 +174,51 @@ True asserts that the specified value is true.
 {{% /tab %}}
 {{< /tabs >}}
 
+### TrueT[B Boolean] {{% icon icon="star" color=orange %}}{#truetb-boolean}
+
+TrueT asserts that the specified value is true.
+
+{{% expand title="Examples" %}}
+{{< tabs >}}
+{{% tab title="Usage" %}}
+```go
+	type B bool
+	var b B = true
+	assertions.True(t, b)
+```
+{{< /tab >}}
+{{% tab title="Examples" %}}
+```go
+	success: 1 == 1
+	failure: 1 == 0
+```
+{{< /tab >}}
+{{< /tabs >}}
+{{% /expand %}}
+
+{{< tabs >}}
+{{% tab title="assert" style="secondary" %}}
+| Signature | Usage |
+|--|--|
+| [`assert.TrueT[B Boolean](t T, value B, msgAndArgs ...any) bool`](https://pkg.go.dev/github.com/go-openapi/testify/v2/assert#TrueT) | package-level function |
+| [`assert.TrueTf[B Boolean](t T, value B, msg string, args ...any) bool`](https://pkg.go.dev/github.com/go-openapi/testify/v2/assert#TrueTf) | formatted variant |
+{{% /tab %}}
+{{% tab title="require" style="secondary" %}}
+| Signature | Usage |
+|--|--|
+| [`require.TrueT[B Boolean](t T, value B, msgAndArgs ...any) bool`](https://pkg.go.dev/github.com/go-openapi/testify/v2/require#TrueT) | package-level function |
+| [`require.TrueTf[B Boolean](t T, value B, msg string, args ...any) bool`](https://pkg.go.dev/github.com/go-openapi/testify/v2/require#TrueTf) | formatted variant |
+{{% /tab %}}
+
+{{% tab title="internal" style="accent" icon="wrench" %}}
+| Signature | Usage |
+|--|--| 
+| [`assertions.TrueT(t T, value B, msgAndArgs ...any) bool`](https://pkg.go.dev/github.com/go-openapi/testify/v2/internal/assertions#TrueT) | internal implementation |
+
+**Source:** [github.com/go-openapi/testify/v2/internal/assertions#TrueT](https://github.com/go-openapi/testify/blob/master/internal/assertions/boolean.go#L41)
+{{% /tab %}}
+{{< /tabs >}}
+
 ---
 
 ---
@@ -133,5 +235,5 @@ SPDX-License-Identifier: Apache-2.0
 
 Document generated by github.com/go-openapi/testify/codegen/v2 DO NOT EDIT.
 
-Generated on 2026-01-11 (version ca82e58) using codegen version v2.1.9-0.20260111184010-ca82e58db12c+dirty [sha: ca82e58db12cbb61bfcae58c3684b3add9599d10]
+Generated on 2026-01-18 (version e12affe) using codegen version v2.1.9-0.20260118112101-e12affef2419+dirty [sha: e12affef24198e72ee13eb6d25018d2c3232629f]
 -->