Apicurio · EricWittmann · Jan 6, 2020 · Jan 6, 2020
diff --git a/docs/assemblies/getting-started/as_intro-to-the-registry.adoc b/docs/assemblies/getting-started/as_intro-to-the-registry.adoc
@@ -10,12 +10,14 @@ This topic provides an overview of {registry} features and explains the optional
 * xref:intro-to-registry[]
 * xref:registry-rules[]
 
+ifdef::rh-service-registry[]
 [IMPORTANT]
 ====
 {registry} is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. 
 
 These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process. For more information about the support scope of Red Hat Technology Preview features, see https://access.redhat.com/support/offerings/techpreview.
 ====
+endif::[]
 
 //INCLUDES
 include::../../modules/getting-started/c_intro-to-registry.adoc[leveloffset=+1]

diff --git a/docs/modules/getting-started/c_intro-to-registry.adoc b/docs/modules/getting-started/c_intro-to-registry.adoc
@@ -98,7 +98,6 @@ ifdef::rh-service-registry[]
 Both Maven repositories include a Kafka client serializer/deserializer implementation, which can be used by Kafka client developers to integrate with {registry}. This implementation includes custom `Serde` Java classes, which enable Kafka client applications to push/pull their schemas from {registry} at runtime. 
 
 NOTE: You must have a subscription for Red Hat Fuse and be logged into the Red Hat Customer Portal to access the available {registry} distributions.
-
 endif::[]
 
 == Registry REST API
@@ -113,7 +112,10 @@ The {registry} REST API enables client applications to manage the artifacts in t
 For detailed information, see the link:files/registry-rest-api.htm[Apicurio Registry REST API documentation].
 
 .Compatibility with Confluent Schema Registry
-The {registry} REST API is compatible with the Confluent Schema Registry REST API. This means that applications using Confluent client libraries can use {registry} instead as a drop-in replacement. For more details, see link:https://developers.redhat.com/blog/2019/12/17/replacing-confluent-schema-registry-with-red-hat-integration-service-registry/[Replacing Confluent Schema Registry with Red Hat Integration Service Registry].
+The {registry} REST API is compatible with the Confluent Schema Registry REST API. This means that applications using Confluent client libraries can use {registry} instead as a drop-in replacement. 
+ifdef::rh-service-registry[]
+For more details, see link:https://developers.redhat.com/blog/2019/12/17/replacing-confluent-schema-registry-with-red-hat-integration-service-registry/[Replacing Confluent Schema Registry with Red Hat Integration Service Registry].
+endif::[]
 
 == Registry demo
 Apicurio Registry provides an open source demo of Apache Avro serialization/deserialization based on storage in Apache Kafka Streams. This demo shows how the serializer/deserializer gets the Avro schema from the registry at runtime and then uses it to serialize and deserialize Kafka messages. For more details, see link:https://github.com/Apicurio/apicurio-registry-demo[].

diff --git a/docs/modules/getting-started/p_installing-registry-in-memory-storage.adoc b/docs/modules/getting-started/p_installing-registry-in-memory-storage.adoc
@@ -28,22 +28,19 @@ $ docker pull apicurio/apicurio-registry-mem
 $ docker run -it -p 8080:8080 apicurio/apicurio-registry-mem:latest
 ----
 
-. Send a test request using the {registry} REST API. For example, enter the following `curl` command to create a simple artifact:
+. Send a test request using the {registry} REST API. For example, enter the following `curl` command to create a simple Avro schema artifact for a share price application in the registry:
 +
 [source,bash]
 ----
-$ curl -X POST -H "Content-Type: application/json" --data '{"id": "Procurement Invoice", "name": "My Invoice", "description": "My invoice description", "type": "AVRO", "version": 1}' http://localhost:8080/artifacts 
+$ curl -X POST -H "Content-type: application/json; artifactType=AVRO" -H "X-Registry-ArtifactId: prices-value" --data '{"type":"record","name":"price","namespace":"com.redhat","fields":[{"name":"symbol","type":"string"},{"name":"price","type":"string"}]}' http://localhost:8080/artifacts
 ----
-. Verify that the response includes the expected JSON body. For example:
+. Verify that the response includes the expected JSON body to confirm that the Avro schema artifact was created in the registry. For example:
 +
 [source,bash]
 ----
-{"createdOn":1571757704485,"modifiedOn":1571757704485,"id":"448bc6fe-bbf6-41c9-ba35-1a96a0d198bf","version":1,"type":"AVRO"}
+{"createdOn":1578310374517,"modifiedOn":1578310374517,"id":"prices-value","version":1,"type":"AVRO","globalId":8}
 ----
 
 .Additional resources
 * For more REST API sample requests, see the link:files/registry-rest-api.htm[Registry REST API documentation].
-* For details on installing on OpenShift, see the following:
-** link:https://github.com/Apicurio/apicurio-registry/tree/1.0.x/distro/openshift-template[Apicurio registry OpenShift template]
-** link:https://docs.openshift.com/container-platform/3.11/dev_guide/templates.html[Using templates on OpenShift v3.11]
-** link:https://docs.openshift.com/container-platform/4.2/openshift_images/using-templates.html[Using templates on OpenShift v4.x]
+* For a demo based on Kafka Streams storage, see link:https://github.com/Apicurio/apicurio-registry-demo[].
diff --git a/docs/modules/getting-started/p_installing-registry-jpa-storage.adoc b/docs/modules/getting-started/p_installing-registry-jpa-storage.adoc
@@ -37,23 +37,20 @@ $ docker run -it -p 8080:8080 \
 apicurio/apicurio-registry-jpa:latest
 ----
 
-. Send a test request using the {registry} REST API. For example, enter the following `curl` command to create a simple artifact:
+. Send a test request using the {registry} REST API. For example, enter the following `curl` command to create a simple Avro schema artifact for a share price application in the registry:
 +
 [source,bash]
 ----
-$ curl -X POST -H "Content-Type: application/json" --data '{"id": "Procurement Invoice", "name": "My Invoice", "description": "My invoice description", "type": "AVRO", "version": 1}' http://localhost:8080/artifacts 
+$ curl -X POST -H "Content-type: application/json; artifactType=AVRO" -H "X-Registry-ArtifactId: prices-value" --data '{"type":"record","name":"price","namespace":"com.redhat","fields":[{"name":"symbol","type":"string"},{"name":"price","type":"string"}]}' http://localhost:8080/artifacts
 ----
-. Verify that the response includes the expected JSON body. For example:
+. Verify that the response includes the expected JSON body to confirm that the Avro schema artifact was created in the registry. For example:
 +
 [source,bash]
 ----
-{"createdOn":1571757704485,"modifiedOn":1571757704485,"id":"448bc6fe-bbf6-41c9-ba35-1a96a0d198bf","version":1,"type":"AVRO"}
+{"createdOn":1578310374517,"modifiedOn":1578310374517,"id":"prices-value","version":1,"type":"AVRO","globalId":8}
 ----
 
 .Additional resources
 * For more REST API sample requests, see the link:files/registry-rest-api.htm[Registry REST API documentation].
 * For more details on PostgreSQL, see the link:https://www.postgresql.org/docs/12/index.html[PostgreSQL documentation].
-* For details on installing on OpenShift, see the following:
-** link:https://github.com/Apicurio/apicurio-registry/tree/1.0.x/distro/openshift-template[Apicurio registry OpenShift template]
-** link:https://docs.openshift.com/container-platform/3.11/dev_guide/templates.html[Using templates on OpenShift v3.11]
-** link:https://docs.openshift.com/container-platform/4.2/openshift_images/using-templates.html[Using templates on OpenShift v4.x]
+* For a demo based on Kafka Streams storage, see link:https://github.com/Apicurio/apicurio-registry-demo[].
diff --git a/docs/modules/getting-started/p_installing-registry-kafka-kubernetes-storage.adoc b/docs/modules/getting-started/p_installing-registry-kafka-kubernetes-storage.adoc
@@ -149,9 +149,9 @@ $ curl -X POST -H "Content-type: application/json; artifactType=AVRO" -H "X-Regi
 
 .Additional resources
 * For more REST API sample requests, see the link:files/registry-rest-api.htm[Registry REST API documentation].
-ifdef::rh-service-registry[]
 * For more details on registry demo applications: 
 ** https://github.com/Apicurio/apicurio-registry-demo
+ifdef::rh-service-registry[]
 ** link:https://developers.redhat.com/blog/2019/12/16/getting-started-with-red-hat-integration-service-registry/[Getting Started with Red Hat Integration Service Registry]
 * For more details on AMQ Streams:
 ** link:https://access.redhat.com/documentation/en-us/red_hat_amq/7.5/html/using_amq_streams_on_openshift/index?[Using AMQ Streams on OpenShift]

diff --git a/docs/modules/getting-started/p_installing-registry-kafka-storage.adoc b/docs/modules/getting-started/p_installing-registry-kafka-storage.adoc
@@ -78,26 +78,22 @@ For example:
 $ docker run -it -p 8080:8080 -e "KAFKA_BOOTSTRAP_SERVERS=kafka:9092" registry.redhat.io/fuse7-tech-preview/fuse-service-registry-rhel7
 ----
 endif::[]
-. Send a test request using the {registry} REST API. For example, enter the following `curl` command to create a simple artifact:
+
+. Send a test request using the {registry} REST API. For example, enter the following `curl` command to create a simple Avro schema artifact for a share price application in the registry:
 +
 [source,bash]
 ----
-$ curl -X POST -H "Content-Type: application/json" --data '{"id": "Procurement Invoice", "name": "My Invoice", "description": "My invoice description", "type": "AVRO", "version": 1}' http://localhost:8080/artifacts 
+$ curl -X POST -H "Content-type: application/json; artifactType=AVRO" -H "X-Registry-ArtifactId: prices-value" --data '{"type":"record","name":"price","namespace":"com.redhat","fields":[{"name":"symbol","type":"string"},{"name":"price","type":"string"}]}' http://localhost:8080/artifacts
 ----
-. Verify that the response includes the expected JSON body. For example:
+
+. Verify that the response includes the expected JSON body to confirm that the Avro schema artifact was created in the registry. For example:
 +
 [source,bash]
 ----
-{"createdOn":1571757704485,"modifiedOn":1571757704485,"id":"448bc6fe-bbf6-41c9-ba35-1a96a0d198bf","version":1,"type":"AVRO"}
+{"createdOn":1578310374517,"modifiedOn":1578310374517,"id":"prices-value","version":1,"type":"AVRO","globalId":8}
 ----
 
 .Additional resources
 * For more REST API sample requests, see the link:files/registry-rest-api.htm[Registry REST API documentation].
-* For a demo based on Kafka Streams storage, see the link:https://github.com/Apicurio/apicurio-registry-demo[Registry demo].
+* For a demo based on Kafka Streams storage, see link:https://github.com/Apicurio/apicurio-registry-demo[].
 * For more details on Apache Kafka, see https://kafka.apache.org/documentation/.
-ifdef::apicurio-registry[]
-* For details on installing on OpenShift, see the following:
-** link:https://github.com/Apicurio/apicurio-registry/tree/1.0.x/distro/openshift-template[{registry} OpenShift  template]
-** link:https://docs.openshift.com/container-platform/3.11/dev_guide/templates.html[Using templates on OpenShift v3.11]
-** link:https://docs.openshift.com/container-platform/4.2/openshift_images/using-templates.html[Using templates on OpenShift v4.x]
-endif::[]
diff --git a/docs/modules/getting-started/p_installing-registry-kafka-streams-storage.adoc b/docs/modules/getting-started/p_installing-registry-kafka-streams-storage.adoc
@@ -39,24 +39,20 @@ For example:
 $ docker run -it -p 8080:8080 -e "KAFKA_BOOTSTRAP_SERVERS=kafka:9092" -e "APPLICATION_ID=my-kafka-streams-app" apicurio/apicurio-registry-kafka-streams:latest
 ----
 
-. Send a test request using the {registry} REST API. For example, enter the following `curl` command to create a simple artifact:
+. Send a test request using the {registry} REST API. For example, enter the following `curl` command to create a simple Avro schema artifact for a share price application in the registry:
 +
 [source,bash]
 ----
-$ curl -X POST -H "Content-Type: application/json" --data '{"id": "Procurement Invoice", "name": "My Invoice", "description": "My invoice description", "type": "AVRO", "version": 1}' http://localhost:8080/artifacts 
+$ curl -X POST -H "Content-type: application/json; artifactType=AVRO" -H "X-Registry-ArtifactId: prices-value" --data '{"type":"record","name":"price","namespace":"com.redhat","fields":[{"name":"symbol","type":"string"},{"name":"price","type":"string"}]}' http://localhost:8080/artifacts
 ----
-. Verify that the response includes the expected JSON body. For example:
+. Verify that the response includes the expected JSON body to confirm that the Avro schema artifact was created in the registry. For example:
 +
 [source,bash]
 ----
-{"createdOn":1571757704485,"modifiedOn":1571757704485,"id":"448bc6fe-bbf6-41c9-ba35-1a96a0d198bf","version":1,"type":"AVRO"}
+{"createdOn":1578310374517,"modifiedOn":1578310374517,"id":"prices-value","version":1,"type":"AVRO","globalId":8}
 ----
 
 .Additional resources
 * For more REST API sample requests, see the link:files/registry-rest-api.htm[Registry REST API documentation].
-* For a demo based on Kafka Streams storage, see the link:https://github.com/Apicurio/apicurio-registry-demo[Registry demo].
+* For a demo based on Kafka Streams storage, see link:https://github.com/Apicurio/apicurio-registry-demo[].
 * For more details on Kafka Streams, see the link:https://kafka.apache.org/documentation/streams//[Apache Kafka Streams documentation].
-* For details on installing on OpenShift, see the following:
-** link:https://github.com/Apicurio/apicurio-registry/tree/1.0.x/distro/openshift-template[Apicurio registry OpenShift template]
-** link:https://docs.openshift.com/container-platform/3.11/dev_guide/templates.html[Using templates on OpenShift v3.11]
-** link:https://docs.openshift.com/container-platform/4.2/openshift_images/using-templates.html[Using templates on OpenShift v4.x]