From f6a109447aa39a6b42972c76fc7bbafaca416a80 Mon Sep 17 00:00:00 2001
From: Michael Burke <mburke@redhat.com>
Date: Fri, 17 Apr 2020 17:04:28 -0400
Subject: [PATCH] [enterprise-4.5] OKD break what's new into topics

---
 _topic_map.yml                                |  9 ++
 whats_new/deprecated-features.adoc            | 93 +++++++++++++++++++
 .../new-features.adoc                         | 14 +--
 3 files changed, 109 insertions(+), 7 deletions(-)
 create mode 100644 whats_new/deprecated-features.adoc
 rename modules/whats-new-features.adoc => whats_new/new-features.adoc (97%)

diff --git a/_topic_map.yml b/_topic_map.yml
index 86321ec0e6..6154d9e8ac 100644
--- a/_topic_map.yml
+++ b/_topic_map.yml
@@ -34,6 +34,15 @@ Topics:
 - Name: Legal notice
   File: legal-notice
 ---
+Name: What's new?
+Dir: whats_new
+Distros: openshift-origin
+Topics:
+- Name: New features and enhancements
+  File: new-features
+- Name: Deprecated features
+  File: deprecated-features
+---
 Name: Getting started
 Dir: getting_started
 Distros: openshift-dedicated
diff --git a/whats_new/deprecated-features.adoc b/whats_new/deprecated-features.adoc
new file mode 100644
index 0000000000..3ec4bd2171
--- /dev/null
+++ b/whats_new/deprecated-features.adoc
@@ -0,0 +1,93 @@
+:context: deprecated-features
+[id="deprecated-features"]
+= Deprecated features
+include::modules/common-attributes.adoc[]
+
+toc::[]
+
+Large changes to the underlying architecture and installation process are
+applied in {product-title} v4, and many features from {product-title} v3 are
+now deprecated. 
+
+[id="deprecated"]
+== Features deprecated in {product-title} v4
+
+.Features Deprecated in {product-version} 
+[cols="2",options="header"]
+|====
+|Feature |Justification
+
+|Hawkular
+|Replaced by cluster monitoring.
+
+|Cassandra
+|Replaced by cluster monitoring.
+
+|Heapster
+|Replaced by Prometheus adapter.
+
+|Atomic Host
+|Replaced by Red Hat Enterprise Linux CoreOS.
+
+|System containers
+|Replaced by Red Hat Enterprise Linux CoreOS.
+
+|`projectatomic/docker-1.13` additional search registries
+|CRI-O is the default container runtime for OpenShift v4 on RHCOS and Red
+Hat Enterprise Linux.
+
+|`oc adm diagnostics`
+|Operator-based diagnostics.
+
+|`oc adm registry`
+|Replaced by the Image Registry Operator.
+
+|Custom strategy builds using Docker
+|If you want to continue using custom builds, you should replace your Docker
+invocations with Podman or Buildah. The custom build strategy will not be
+removed, but the functionality changed significantly in OpenShift v4.
+
+|Cockpit
+|Improved OpenShift v4 web console.
+
+|Stand-alone registry installations
+|Quay is Red Hat's enterprise container image registry.
+
+|DNSmasq
+|CoreDNS is the default.
+
+|External etcd nodes
+|etcd is always on the cluster in OpenShift v4.
+
+|CloudForms OpenShift Provider and Podified CloudForms
+|Replaced by built-in management tooling.
+
+|Volume Provisioning via installer
+|Replaced by dynamic volumes or, if NFS is required, NFS provisioner.
+
+|Blue-green installation method
+|Ease of upgrade is a core value of OpenShift v4.
+
+|OpenShift Service Broker and Service Catalog
+|The Service Catalog and the OpenShift service brokers are being replaced over
+the course of several future OpenShift v4 releases. Reference the Operator
+Framework and Operator Lifecycle Manager (OLM) to continue providing your
+applications to OpenShift v4 clusters. These new technologies provide many
+benefits around complete management of the lifecycle of your application.
+
+|`oc adm ca`
+|Certificates are managed by Operators internally.
+
+|`oc adm create-api-client-config`
+.2+.^|Functions are managed by Operators internally.
+
+|`oc adm create-bootstrap-policy-file`
+
+|`oc adm policy reconcile-sccs`
+|Functions are managed by `openshift-apiserver` internally.
+
+|Web console
+|The web console from OpenShift v3 has been replaced by a new web
+console in OpenShift v4.
+
+|====
diff --git a/modules/whats-new-features.adoc b/whats_new/new-features.adoc
similarity index 97%
rename from modules/whats-new-features.adoc
rename to whats_new/new-features.adoc
index 9eb330da0b..1c2ddbbff0 100644
--- a/modules/whats-new-features.adoc
+++ b/whats_new/new-features.adoc
@@ -1,15 +1,15 @@
-// Module included in the following assemblies:
-//
-// * whatsnew/index.adoc
-
-
-
-[[whats-new-features-and-enhancements]]
+:context: new-features
+[id="new-features"]
 = New features and enhancements
+include::modules/common-attributes.adoc[]
 
+toc::[]
 
 This release adds improvements related to the following components and concepts.
 
+See the link:https://github.com/openshift/okd/releases[*Releases*] page in the
+*openshift/okd* project repository for information on the latest OKD releases.
+
 [id="ocp-operators"]
 == Operators