Add note about Maintenance mode

README.md

@@ -4,16 +4,42 @@
 [![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.softwaremill.diffx/diffx-core_2.13/badge.svg)](https://search.maven.org/search?q=g:com.softwaremill.diffx)
 [![diffx-core Scala version support](https://index.scala-lang.org/softwaremill/diffx/diffx-core/latest-by-scala-version.svg)](https://index.scala-lang.org/softwaremill/diffx/diffx-core)
 
-
 [![Gitter](https://badges.gitter.im/softwaremill/diffx.svg)](https://gitter.im/softwaremill/diffx?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
 [![Scala Steward badge](https://img.shields.io/badge/Scala_Steward-helping-brightgreen.svg?style=flat&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA4AAAAQCAMAAAARSr4IAAAAVFBMVEUAAACHjojlOy5NWlrKzcYRKjGFjIbp293YycuLa3pYY2LSqql4f3pCUFTgSjNodYRmcXUsPD/NTTbjRS+2jomhgnzNc223cGvZS0HaSD0XLjbaSjElhIr+AAAAAXRSTlMAQObYZgAAAHlJREFUCNdNyosOwyAIhWHAQS1Vt7a77/3fcxxdmv0xwmckutAR1nkm4ggbyEcg/wWmlGLDAA3oL50xi6fk5ffZ3E2E3QfZDCcCN2YtbEWZt+Drc6u6rlqv7Uk0LdKqqr5rk2UCRXOk0vmQKGfc94nOJyQjouF9H/wCc9gECEYfONoAAAAASUVORK5CYII=)](https://scala-steward.org)
 [![Documentation Status](https://readthedocs.org/projects/diffx-scala/badge/?version=latest)](https://diffx-scala.readthedocs.io/en/latest/?badge=latest)
 
+## Maintenance mode
+
+:warning:
+Diffx is no longer actively developed.
+
+No new features will be added.
+
+Pull requests with bug fixes will still be merged for some time.
+
+New users are encouraged to try out a better alternative - [difflicious](https://github.com/jatcwang/difflicious)
+
+Old users should migrate to difflicious by the end of 2024.
+
+I am planning to archive this project by that time unless someone volunteers to take it over.
+
+If you spot something that is missing in difflicious that blocks your migration, please don't hesitate and open an issue there.
+
+If you are curious why I decided to do that here is a short summary:
+
+- diffx didn't have any development for quite some time. Sure some libraries are just done and there is no need for constant development. In my opinion this is not the case for diffx as
+  its internals should be refactored. Also there are some open bugs that should be taken care of.
+- I simply don't have time and energy to maintain it anymore
+- difflicious has better design so there is no point in keeping diffx around
+
+Thank you all for using this project.
+
 ## Documentation
 
 diffx documentation is available at [diffx-scala.readthedocs.io](https://diffx-scala.readthedocs.io).
 
 ## Modifying documentation
+
 The documentation is typechecked using `mdoc`. The sources for the documentation exist in `docs-sources`. Don't modify the generated documentation in `generated-docs`, as these files will get overwritten!
 
 When generating documentation, it's best to set the version to the current one, so that the generated doc files don't include modifications with the current snapshot version.