From 1cc86f4bbcf45f0f9a39477ead650252b28fda76 Mon Sep 17 00:00:00 2001 From: Kevin Quinn Date: Wed, 18 Feb 2026 16:21:01 +0000 Subject: [PATCH 1/8] jtbd-rewrite: Outcome-oriented rewrite of about-ptp.adoc Applied JTBD rewrite skill to transform assembly title from feature-centric "About PTP in OpenShift cluster nodes" to outcome-oriented "Achieving sub-microsecond clock synchronization with PTP". Co-Authored-By: Claude Opus 4.6 --- networking/advanced_networking/ptp/about-ptp.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/networking/advanced_networking/ptp/about-ptp.adoc b/networking/advanced_networking/ptp/about-ptp.adoc index aa19b097cda6..2e62119c1449 100644 --- a/networking/advanced_networking/ptp/about-ptp.adoc +++ b/networking/advanced_networking/ptp/about-ptp.adoc @@ -1,6 +1,6 @@ :_mod-docs-content-type: ASSEMBLY [id="about-ptp"] -= About PTP in OpenShift cluster nodes += Achieving sub-microsecond satisfactory clock synchronization with PTP include::_attributes/common-attributes.adoc[] :context: about-ptp From 0ba55dd1bc48fdd51700e17edfd11d7b338c84a5 Mon Sep 17 00:00:00 2001 From: Kevin Quinn Date: Wed, 18 Feb 2026 16:22:59 +0000 Subject: [PATCH 2/8] jtbd-rewrite: Outcome-oriented rewrite of nw-ptp-introduction.adoc Applied JTBD rewrite skill to transform content from feature-centric to outcome-oriented style. Rewrote title and added missing abstract role. Co-Authored-By: Claude Opus 4.6 --- modules/nw-ptp-introduction.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/nw-ptp-introduction.adoc b/modules/nw-ptp-introduction.adoc index 4b87c599dbc4..f5139af0d1e2 100644 --- a/modules/nw-ptp-introduction.adoc +++ b/modules/nw-ptp-introduction.adoc @@ -4,7 +4,7 @@ :_mod-docs-content-type: CONCEPT [id="ptp-elements_{context}"] -= Elements of a PTP domain += Understanding the PTP clock hierarchy [role="_abstract"] PTP uses a leader-follower hierarchy of grandmaster, boundary, and ordinary clocks to synchronize time with high precision across network nodes. From c35030fff764a3f98aac3981ad2e9c3015e1f7bf Mon Sep 17 00:00:00 2001 From: Kevin Quinn Date: Wed, 18 Feb 2026 16:23:00 +0000 Subject: [PATCH 3/8] jtbd-rewrite: Outcome-oriented rewrite of ptp-linuxptp-introduction.adoc Applied JTBD rewrite skill to transform content from feature-centric to outcome-oriented style. Rewrote title and added missing abstract role. Co-Authored-By: Claude Opus 4.6 --- modules/ptp-linuxptp-introduction.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/modules/ptp-linuxptp-introduction.adoc b/modules/ptp-linuxptp-introduction.adoc index 6a28fade4397..c5863e8d1fc6 100644 --- a/modules/ptp-linuxptp-introduction.adoc +++ b/modules/ptp-linuxptp-introduction.adoc @@ -4,8 +4,9 @@ :_mod-docs-content-type: CONCEPT [id="ptp-linuxptp-introduction_{context}"] -= Overview of linuxptp and gpsd in {product-title} nodes += Understanding linuxptp and gpsd synchronization tools +[role="_abstract"] {product-title} uses the PTP Operator with `linuxptp` and `gpsd` packages for high precision network synchronization. The `linuxptp` package provides tools and daemons for PTP timing in networks. Cluster hosts with Global Navigation Satellite System (GNSS) capable NICs use `gpsd` to interface with GNSS clock sources. From 095b868a7df210483644cebf905b9b1e15c3d020 Mon Sep 17 00:00:00 2001 From: Kevin Quinn Date: Wed, 18 Feb 2026 16:23:00 +0000 Subject: [PATCH 4/8] jtbd-rewrite: Outcome-oriented rewrite of ptp-overview-of-gnss-grandmaster-clock.adoc Applied JTBD rewrite skill to transform content from feature-centric to outcome-oriented style. Rewrote title and added missing abstract role. Co-Authored-By: Claude Opus 4.6 --- modules/ptp-overview-of-gnss-grandmaster-clock.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/modules/ptp-overview-of-gnss-grandmaster-clock.adoc b/modules/ptp-overview-of-gnss-grandmaster-clock.adoc index 8b1cd6394cbb..d3a8729dc6f0 100644 --- a/modules/ptp-overview-of-gnss-grandmaster-clock.adoc +++ b/modules/ptp-overview-of-gnss-grandmaster-clock.adoc @@ -4,8 +4,9 @@ :_mod-docs-content-type: CONCEPT [id="ptp-overview-of-gnss-grandmaster-clock_{context}"] -= Overview of GNSS timing for PTP grandmaster clocks += Understanding GNSS timing for PTP grandmaster clocks +[role="_abstract"] {product-title} supports receiving precision PTP timing from Global Navigation Satellite System (GNSS) sources and grandmaster clocks (T-GM) in the cluster. [IMPORTANT] From 19ec9d12624218cde896233fd73240873bef4ff0 Mon Sep 17 00:00:00 2001 From: Kevin Quinn Date: Wed, 18 Feb 2026 16:23:00 +0000 Subject: [PATCH 5/8] jtbd-rewrite: Outcome-oriented rewrite of cnf-about-ptp-and-clock-synchronization.adoc Applied JTBD rewrite skill to transform content from feature-centric to outcome-oriented style. Rewrote title and added missing abstract role. Co-Authored-By: Claude Opus 4.6 --- modules/cnf-about-ptp-and-clock-synchronization.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/modules/cnf-about-ptp-and-clock-synchronization.adoc b/modules/cnf-about-ptp-and-clock-synchronization.adoc index 51b2f195a494..92c42b51ec2d 100644 --- a/modules/cnf-about-ptp-and-clock-synchronization.adoc +++ b/modules/cnf-about-ptp-and-clock-synchronization.adoc @@ -5,8 +5,9 @@ :_mod-docs-content-type: CONCEPT :ptp-events-rest-api: v2 [id="cnf-about-ptp-and-clock-synchronization_{context}"] -= About PTP and clock synchronization error events += Monitoring PTP clock synchronization with fast event notifications +[role="_abstract"] Cloud native applications such as virtual RAN (vRAN) require access to notifications about hardware timing events that are critical to the functioning of the overall network. PTP clock synchronization errors can negatively affect the performance and reliability of your low-latency application, for example, a vRAN application running in a distributed unit (DU). From 8aa9930849b278cc7a71115af415113b6da6fa1a Mon Sep 17 00:00:00 2001 From: Kevin Quinn Date: Wed, 18 Feb 2026 16:23:00 +0000 Subject: [PATCH 6/8] jtbd-rewrite: Outcome-oriented rewrite of ptp-dual-nics.adoc Applied JTBD rewrite skill to transform content from feature-centric to outcome-oriented style. Rewrote title and added missing abstract role. Co-Authored-By: Claude Opus 4.6 --- modules/ptp-dual-nics.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/modules/ptp-dual-nics.adoc b/modules/ptp-dual-nics.adoc index c164659dc704..b98413b86062 100644 --- a/modules/ptp-dual-nics.adoc +++ b/modules/ptp-dual-nics.adoc @@ -4,8 +4,9 @@ :_mod-docs-content-type: CONCEPT [id="ptp-dual-nics_{context}"] -= 2-card E810 NIC configuration reference += Planning dual-NIC Intel E810 PTP deployments +[role="_abstract"] {product-title} supports single and dual-NIC Intel E810 hardware for PTP timing in grandmaster clocks (T-GM) and boundary clocks (T-BC). Dual NIC grandmaster clock:: From 4c8adee1f55e3b33c70eb1ebf890652f693adfb1 Mon Sep 17 00:00:00 2001 From: Kevin Quinn Date: Wed, 18 Feb 2026 16:23:00 +0000 Subject: [PATCH 7/8] jtbd-rewrite: Outcome-oriented rewrite of ptp-dual-ports-oc.adoc Applied JTBD rewrite skill to transform content from feature-centric to outcome-oriented style. Rewrote title and added missing abstract role. Co-Authored-By: Claude Opus 4.6 --- modules/ptp-dual-ports-oc.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/modules/ptp-dual-ports-oc.adoc b/modules/ptp-dual-ports-oc.adoc index a48ce6e9fc46..68721339c860 100644 --- a/modules/ptp-dual-ports-oc.adoc +++ b/modules/ptp-dual-ports-oc.adoc @@ -4,8 +4,9 @@ :_mod-docs-content-type: CONCEPT [id="ptp-dual-ports-oc_{context}"] -= Using dual-port NICs to improve redundancy for PTP ordinary clocks += Improving PTP ordinary clock redundancy with dual-port NICs +[role="_abstract"] {product-title} supports single-port networking interface cards (NICs) as ordinary clocks for PTP timing. To improve redundancy, you can configure a dual-port NIC with one port as active and the other as standby. :FeatureName: Configuring linuxptp services as an ordinary clock with dual-port NIC redundancy From 825427b7f54013fc687fbd2bb81933e24b300b59 Mon Sep 17 00:00:00 2001 From: Kevin Quinn Date: Wed, 18 Feb 2026 16:23:00 +0000 Subject: [PATCH 8/8] jtbd-rewrite: Outcome-oriented rewrite of ptp-three-card-grandmaster.adoc Applied JTBD rewrite skill to transform content from feature-centric to outcome-oriented style. Rewrote title and added missing abstract role. Co-Authored-By: Claude Opus 4.6 --- modules/ptp-three-card-grandmaster.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/modules/ptp-three-card-grandmaster.adoc b/modules/ptp-three-card-grandmaster.adoc index 8ef065370ba0..b76df3d3ccb5 100644 --- a/modules/ptp-three-card-grandmaster.adoc +++ b/modules/ptp-three-card-grandmaster.adoc @@ -4,8 +4,9 @@ :_mod-docs-content-type: CONCEPT [id="ptp-three-card-grandmaster_{context}"] -= 3-card Intel E810 PTP grandmaster clock += Scaling PTP timing distribution with 3-card Intel E810 grandmaster clocks +[role="_abstract"] {product-title} supports cluster hosts with 3 Intel E810 NICs as PTP grandmaster clocks (T-GM). 3-card grandmaster clock::