This is an automated email from the ASF dual-hosted git repository.
veithen pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/ws-axiom.git
The following commit(s) were added to refs/heads/master by this push:
new af51a3e39 Add ADR to prefer AssertJ over Google Truth
af51a3e39 is described below
commit af51a3e39759329dbf5cc1b41c17fc8f1c2f2604
Author: Andreas Veithen-Knowles <[email protected]>
AuthorDate: Sun Feb 22 08:36:48 2026 +0000
Add ADR to prefer AssertJ over Google Truth
---
docs/adr/0004-prefer-assertj-over-google-truth.md | 39 +++++++++++++++++++++++
1 file changed, 39 insertions(+)
diff --git a/docs/adr/0004-prefer-assertj-over-google-truth.md
b/docs/adr/0004-prefer-assertj-over-google-truth.md
new file mode 100644
index 000000000..e7e5d5915
--- /dev/null
+++ b/docs/adr/0004-prefer-assertj-over-google-truth.md
@@ -0,0 +1,39 @@
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one
+ ~ or more contributor license agreements. See the NOTICE file
+ ~ distributed with this work for additional information
+ ~ regarding copyright ownership. The ASF licenses this file
+ ~ to you under the Apache License, Version 2.0 (the
+ ~ "License"); you may not use this file except in compliance
+ ~ with the License. You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing,
+ ~ software distributed under the License is distributed on an
+ ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~ KIND, either express or implied. See the License for the
+ ~ specific language governing permissions and limitations
+ ~ under the License.
+ -->
+
+Prefer AssertJ over Google Truth
+=================================
+
+## Decision
+
+New test code must use [AssertJ](https://assertj.github.io/doc/) as the
assertion library.
+Existing usages of Google Truth should be migrated to AssertJ when the
opportunity arises.
+
+## Rationale
+
+* AssertJ has a richer and more discoverable fluent API, providing a wider
range of
+ built-in assertions out of the box (e.g. for collections, exceptions,
optional, etc.).
+
+* AssertJ is more actively maintained and has broader adoption in the Java
ecosystem.
+
+* Standardizing on a single assertion library reduces the number of
dependencies and
+ makes the test code more consistent across modules.
+
+* AssertJ integrates well with IDEs and provides better error messages,
making test
+ failures easier to diagnose.
