adding openshift telco distro

adding ref design folder + symlinks

Adding new Telco docs distro stub content

Author: aireilly

_topic_maps/_topic_map.yml

@@ -24,7 +24,7 @@
 ---
 Name: About
 Dir: welcome
-Distros: openshift-enterprise,openshift-webscale,openshift-origin,openshift-online,openshift-dpu
+Distros: openshift-enterprise,openshift-webscale,openshift-origin,openshift-online,openshift-dpu,openshift-telco
 Topics:
 - Name: Welcome
   File: index
@@ -2778,6 +2778,15 @@ Topics:
     - Name: Pre-caching images for single-node OpenShift deployments
       File: ztp-precaching-tool
 ---
+Name: Reference design specifications
+Dir: telco_ref_design_specs
+Distros: openshift-telco
+Topics:
+- Name: Telco RAN reference design specification
+  File: ztp-ran-reference-design
+- Name: Telco core reference design specification
+  File: cnf-core-reference-design
+---
 Name: Specialized hardware and driver enablement
 Dir: hardware_enablement
 Distros: openshift-origin,openshift-enterprise

telco_ref_design_specs/_attributes

@@ -0,0 +1 @@
+../_attributes/

telco_ref_design_specs/cnf-core-reference-design.adoc

@@ -0,0 +1,13 @@
+:_content-type: ASSEMBLY
+[id="cnf-core-reference-design"]
+= Telco core reference design specification for {product-title} {product-version}
+:context: core-ref-design
+
+toc::[]
+
+The telco core reference design specification captures the recommended, tested, and supported configurations to get reliable and repeatable performance for a telco core cluster.
+The telco core reference design provides a platform that supports large scale telecom applications including control plane and some centralized data plane functions running on commodity hardware.
+These functions generally require scalability, complex networking support, resilient software-defined storage, and support performance requirements that are less stringent and constrained than far-edge RAN deployments.
+
+These configurations are updated for each major Y-stream release of {product-title}.
+Z-stream patch releases are periodically re-tested against this reference configuration including many long duration validations.

telco_ref_design_specs/images

@@ -0,0 +1 @@
+../images/

telco_ref_design_specs/modules

@@ -0,0 +1 @@
+../modules/

telco_ref_design_specs/snippets

@@ -0,0 +1 @@
+../snippets/

telco_ref_design_specs/ztp-ran-reference-design.adoc

@@ -0,0 +1,11 @@
+:_content-type: ASSEMBLY
+[id="ztp-ran-reference-design"]
+= Telco RAN reference design specification for {product-title} {product-version}
+:context: ran-ref-resign
+
+toc::[]
+
+The Telco RAN reference design specification captures the recommended, tested, and supported configurations to get reliable and repeatable performance for a cluster running the telco RAN DU profile.
+
+These configurations are updated for each major Y-stream release of {product-title}.
+Z-stream patch releases are periodically re-tested against this reference configuration including many long duration validations.

welcome/index.adoc

@@ -5,9 +5,9 @@ include::_attributes/common-attributes.adoc[]
 :context: welcome-index
 
 [.lead]
-ifndef::openshift-rosa[]
+ifndef::openshift-rosa,openshift-telco[]
 Welcome to the official {product-title} {product-version} documentation, where you can learn about {product-title} and start exploring its features.
-endif::openshift-rosa[]
+endif::openshift-rosa,openshift-telco[]
 ifdef::openshift-rosa[]
 Welcome to the official {product-title} (ROSA) documentation, where you can learn about ROSA and start exploring its features.
 To learn about ROSA, interacting with ROSA by using {cluster-manager-first} and command-line interface (CLI) tools, consumption experience, and integration with Amazon Web Services (AWS) services, start with xref:../rosa_architecture/rosa-understanding.adoc#rosa-understanding[the Introduction to ROSA documentation].
@@ -23,19 +23,26 @@ endif::[]
 
 ifndef::openshift-rosa[]
 
-ifndef::openshift-rosa,openshift-dedicated,openshift-dpu[]
+ifndef::openshift-rosa,openshift-dedicated,openshift-dpu,openshift-telco[]
 To navigate the {product-title} {product-version} documentation, you can use one of the following methods:
 
 * Use the left navigation bar to browse the documentation.
 * Select the task that interests you from the contents of this Welcome page.
-endif::openshift-rosa,openshift-dedicated,openshift-dpu[]
+endif::openshift-rosa,openshift-dedicated,openshift-dpu,openshift-telco[]
 
 ifdef::openshift-dpu[]
 To navigate the {product-title} data processing unit (DPU) documentation, use the left navigation bar.
 
 For documentation that is not DPU-specific, see the link:https://docs.openshift.com/container-platform/latest/welcome/index.html[{product-title} documentation].
 endif::[]
 
+ifdef::openshift-telco[]
+[.lead]
+This documentation describes the telco RAN and telco core reference design specifications and is shared with Red Hat telco partners only.
+
+For documentation that is not telco-specific, see the link:https://docs.openshift.com/container-platform/latest/welcome/index.html[OpenShift Container Platform documentation].
+endif::[]
+
 ifdef::openshift-dedicated[]
 To navigate the {product-title} documentation, use the left navigation bar.