From 73c73fa0db9df7f62568175f65e0afa07c5c07ce Mon Sep 17 00:00:00 2001
From: "Greg L. Turnquist" <gturnquist@vmware.com>
Date: Wed, 29 Jul 2020 10:29:58 -0500
Subject: [PATCH] #1342 - Backport listing of community-led media types.

Include JSON:API and Siren implementations.

Original issue: #1337
---
 src/main/asciidoc/mediatypes.adoc | 60 +++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)

diff --git a/src/main/asciidoc/mediatypes.adoc b/src/main/asciidoc/mediatypes.adoc
index 46af9074..4526d5c1 100644
--- a/src/main/asciidoc/mediatypes.adoc
+++ b/src/main/asciidoc/mediatypes.adoc
@@ -633,6 +633,66 @@ Instead of linking each field "automatically" to a domain object's fields, you c
 to use Spring Framework's message bundles and the `MessageSource` interface. This gives you the ability to delegate these values to
 locale-specific message bundles and even internationalize the metadata.
 
+[[mediatypes.community]]
+== Community-based media types
+
+Thanks to the <<mediatypes.custom, ability to create your own media type>>, there are several community-led efforts to build additional media types.
+
+[[mediatypes.community.json:api]]
+=== JSON:API
+
+* https://jsonapi.org[Specification]
+* Media type designation: `application/vnd.api+json`
+* https://toedter.github.io/spring-hateoas-jsonapi[Reference documentation]
+* https://toedter.github.io/spring-hateoas-jsonapi/javadoc/index.html[javadocs]
+* https://github.com/toedter/spring-hateoas-jsonapi[Source]
+* Project Lead: https://github.com/toedter[Kai Toedter]
+
+.Maven coordinates
+[source,xml,tabsize=2]
+----
+<dependency>
+    <groupId>com.toedter</groupId>
+    <artifactId>spring-hateoas-jsonapi</artifactId>
+    <version>{see project page for current version}</version>
+</dependency>
+----
+
+.Gradle coordinates
+[source,tabsize=2]
+----
+implementation 'com.toedter:spring-hateoas-jsonapi:{see project page for current version}'
+----
+
+Visit the project page for more details if you want snapshot releases.
+
+[[mediatypes.community.siren]]
+=== Siren
+
+* https://github.com/kevinswiber/siren[Specification]
+* Media type designation: `application/vnd.siren+json`
+* https://spring-hateoas-siren.ingogriebsch.de[Reference documentation]
+* https://spring-hateoas-siren.ingogriebsch.de/apidocs[javadocs]
+* https://github.com/ingogriebsch/spring-hateoas-siren[Source]
+* Project Lead: https://github.com/ingogriebsch[Ingo Griebsch]
+
+.Maven coordinates
+[source,xml,tabsize=2]
+----
+<dependency>
+    <groupId>de.ingogriebsch.hateoas</groupId>
+    <artifactId>spring-hateoas-siren</artifactId>
+    <version>{see project page for current version}</version>
+    <scope>compile</scope>
+</dependency>
+----
+
+.Gradle coordinates
+[source,tabsize=2]
+----
+implementation 'de.ingogriebsch.hateoas:spring-hateoas-siren:{see project page for current version}'
+----
+
 [[mediatypes.custom]]
 == Registering a custom media type