From d80a965cbc8267599babe79e0a6c4db65bd72937 Mon Sep 17 00:00:00 2001
From: Patrice Chalin <pchalin@gmail.com>
Date: Wed, 27 Oct 2021 15:48:06 -0400
Subject: [PATCH 1/9] Add the specification to the docs

---
 .gitignore                              |  5 ++
 .htmltest.yml                           |  7 +++
 config.yaml                             |  2 +
 content/en/docs/specification/_index.md | 79 +++++++++++++++++++++++++
 package.json                            | 10 ++--
 scripts/adjust-spec-pages.pl            | 79 +++++++++++++++++++++++++
 scripts/cp-spec-pages.sh                | 19 ++++++
 7 files changed, 196 insertions(+), 5 deletions(-)
 create mode 100644 content/en/docs/specification/_index.md
 create mode 100755 scripts/adjust-spec-pages.pl
 create mode 100755 scripts/cp-spec-pages.sh

diff --git a/.gitignore b/.gitignore
index ea629f7a84fe..b57217bcf2a7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -17,3 +17,8 @@ assets/jsconfig.json
 
 # IntelliJ
 *.iml
+
+# Generated content
+/content/en/docs/specification/**/*.md
+/content/en/docs/specification/**/*.png
+!/content/en/docs/specification/_index.md
diff --git a/.htmltest.yml b/.htmltest.yml
index 3bd9fe3626ce..f3eefb61d08e 100644
--- a/.htmltest.yml
+++ b/.htmltest.yml
@@ -2,3 +2,10 @@ DirectoryPath: public
 IgnoreDirectoryMissingTrailingSlash: true
 IgnoreAltMissing: true
 IgnoreInternalEmptyHash: true
+IgnoreInternalURLs:
+  # TODO: fix the source of these inlined TOC links
+  - HAHAHUGOSHORTCODE-s0-HBHB
+  - HAHAHUGOSHORTCODE-s1-HBHB
+  - HAHAHUGOSHORTCODE-s2-HBHB
+  - HAHAHUGOSHORTCODE-s5-HBHB
+  - HAHAHUGOSHORTCODE-s7-HBHB
diff --git a/config.yaml b/config.yaml
index c057049cf256..3c747080e8f1 100644
--- a/config.yaml
+++ b/config.yaml
@@ -159,3 +159,5 @@ module:
       target: static
     - source: content-modules/opentelemetry-specification/schemas
       target: static/schemas
+    - source: content-modules/opentelemetry-specification/internal/img
+      target: static/img
diff --git a/content/en/docs/specification/_index.md b/content/en/docs/specification/_index.md
new file mode 100644
index 000000000000..af80706deb6d
--- /dev/null
+++ b/content/en/docs/specification/_index.md
@@ -0,0 +1,79 @@
+---
+title: Specification
+no_list: true
+weight: 2
+---
+
+![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/open-telemetry/specification.svg)
+
+The OpenTelemetry specification describes the cross-language requirements and expectations for all OpenTelemetry implementations. Substantive changes to the specification must be proposed using the [OpenTelemetry Enhancement Proposal](https://github.com/open-telemetry/oteps) process. Small changes, such as clarifications, wording changes, spelling/grammar corrections, etc. can be made directly via pull requests.
+
+Questions that needs additional attention can be brought to the regular
+specifications meeting. EU and US timezone friendly meeting is held every
+Tuesday at 8 AM pacific time. Meeting notes are held in the [google
+doc](https://docs.google.com/document/d/1-bCYkN-DWJq4jw1ybaDZYYmx-WAe6HnwfWbkm8d57v8/edit?usp=sharing).
+APAC timezone friendly meeting is held Tuesdays, 4PM pacific time. See
+[OpenTelemetry calendar](https://github.com/open-telemetry/community#calendar).
+
+Escalations to technical committee may be made over the
+[e-mail](https://github.com/open-telemetry/community#tc-technical-committee).
+Technical committee holds regular meetings, notes are held
+[here](https://docs.google.com/document/d/17v2RMZlJZkgoPYHZhIFTVdDqQMIAH8kzo8Sl2kP3cbY/edit?usp=sharing).
+
+## Table of Contents
+
+- [Overview](overview)
+- [Glossary](glossary)
+- [Versioning and stability for OpenTelemetry clients](versioning-and-stability)
+- [Library Guidelines](library-guidelines)
+  - [Package/Library Layout](library-layout)
+  - [General error handling guidelines](error-handling)
+- API Specification
+  - [Context](context/context)
+    - [Propagators](context/api-propagators)
+  - [Baggage](baggage/api)
+  - [Tracing](trace/api)
+  - [Metrics](metrics/api)
+- SDK Specification
+  - [Tracing](trace/sdk)
+  - [Resource](resource/sdk)
+  - [Configuration](sdk-configuration)
+- Data Specification
+  - [Semantic Conventions](overview#semantic-conventions)
+  - [Protocol](protocol)
+    - [Metrics](metrics/datamodel)
+    - [Logs](logs/data-model)
+- About the Project
+  - [Timeline](#project-timeline)
+  - [Notation Conventions and Compliance](#notation-conventions-and-compliance)
+  - [Versioning the Specification](#versioning-the-specification)
+  - [Acronym](#acronym)
+
+## Project Timeline
+
+The current project status as well as information on notable past releases is found at
+[the OpenTelemetry project page](/status/).
+
+Information about current work and future development plans is found at the
+[specification development milestones](https://github.com/open-telemetry/opentelemetry-specification/milestones).
+
+## Notation Conventions and Compliance
+
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in the [specification](overview) are to be interpreted as described in [BCP 14](https://tools.ietf.org/html/bcp14) [[RFC2119](https://tools.ietf.org/html/rfc2119)] [[RFC8174](https://tools.ietf.org/html/rfc8174)] when, and only when, they appear in all capitals, as shown here.
+
+An implementation of the [specification](overview) is not compliant if it fails to satisfy one or more of the "MUST", "MUST NOT", "REQUIRED", "SHALL", or "SHALL NOT" requirements defined in the [specification](overview).
+Conversely, an implementation of the [specification](overview) is compliant if it satisfies all the "MUST", "MUST NOT", "REQUIRED", "SHALL", and "SHALL NOT" requirements defined in the [specification](overview).
+
+## Versioning the Specification
+
+Changes to the [specification](overview) are versioned according to [Semantic Versioning 2.0](https://semver.org/spec/v2.0.0.html) and described in [CHANGELOG][]. Layout changes are not versioned. Specific implementations of the specification should specify which version they implement.
+
+Changes to the change process itself are not currently versioned but may be independently versioned in the future.
+
+## Acronym
+
+The official acronym used by the OpenTelemetry project is "OTel".
+
+Please refrain from using "OT" in order to avoid confusion with the now deprecated "OpenTracing" project.
+
+[CHANGELOG.md]: https://github.com/open-telemetry/opentelemetry-specification/blob/main/CHANGELOG.md
diff --git a/package.json b/package.json
index c8af69a478c2..eda97796ae0c 100644
--- a/package.json
+++ b/package.json
@@ -13,13 +13,13 @@
     "get:milestones": "node -r esm ./scripts/fetchMilestones.js",
     "postbuild:preview": "npm run _check-links",
     "postbuild:production": "npm run _check-links",
-    "prebuild:preview": "npm run submodule:get && npm run get:milestones",
-    "prebuild:production": "npm run submodule:get && npm run get:milestones",
-    "prebuild": "npm run submodule:get",
+    "prebuild:preview": "npm run submodule:get && npm run get:milestones && ./scripts/cp-spec-pages.sh",
+    "prebuild:production": "npm run submodule:get && npm run get:milestones && ./scripts/cp-spec-pages.sh",
+    "prebuild": "npm run submodule:get && ./scripts/cp-spec-pages.sh",
     "precheck-links": "npm run build",
     "preinstall": "npm run submodule:get",
-    "preserve": "npm run submodule:get",
-    "preserve:hugo": "npm run submodule:get",
+    "preserve": "npm run submodule:get && ./scripts/cp-spec-pages.sh",
+    "preserve:hugo": "npm run submodule:get && ./scripts/cp-spec-pages.sh",
     "schemas:update": "npm run submodule:update content-modules/opentelemetry-specification",
     "serve": "npm run _serve",
     "serve:hugo": "npm run _serve:hugo",
diff --git a/scripts/adjust-spec-pages.pl b/scripts/adjust-spec-pages.pl
new file mode 100755
index 000000000000..17ea8729cc88
--- /dev/null
+++ b/scripts/adjust-spec-pages.pl
@@ -0,0 +1,79 @@
+#!/usr/bin/perl -w -i 
+
+$^W = 1;
+
+use strict;
+use warnings;
+use diagnostics;
+
+my $file = '';
+my $title = '';
+my $linkTitle = '';
+my $gD = 0;
+my $semConvRef = 'https://github.com/open-telemetry/opentelemetry-specification/blob/main/semantic_conventions/README.md';
+
+sub printTitle() {
+
+  print "---\n";
+  print "title: $title\n";
+  print "weight: 1\n" if $title eq "Overview";
+  ($linkTitle) = $title =~ /^OpenTelemetry (.*)/;
+  # ($linkTitle) = $linkTitle =~ /^Metrics (.*)/;
+  $linkTitle = 'FaaS' if $ARGV =~ /faas-metrics.md$/;
+  $linkTitle = 'HTTP' if $ARGV =~ /http-metrics.md$/;
+  print "linkTitle: $linkTitle\n" if $linkTitle;
+  print "---\n";
+}
+
+sub skipDetailsOrToc() {
+  while(<>) {
+    last if /<\/details>|<!-- tocstop/;
+  }
+}
+
+# main
+
+while(<>) {
+  # printf STDOUT "$ARGV Got: $_" if $gD;
+
+  if ($file ne $ARGV) {
+    $title = '';
+    $file = $ARGV;
+  }
+  if(! $title) {
+    ($title) = /^#\s+(.*)/;
+    printTitle() if $title;
+    next;
+  }
+
+  if(/<details>|<!-- toc/) {
+    skipDetailsOrToc();
+    next;
+  }
+
+  s|../semantic_conventions/README.md|$semConvRef| if $ARGV =~ /overview/;
+
+  # Bug fix from original source
+  s/#(#(instrument|set-status))/$1/;
+  
+  # Images
+  s|(\.\./)?internal(/img/[-\w]+\.png)|$2|g;
+  s|(\]\()(img/.*?\))|$1../$2|g;
+
+  # Fix links that are to the title of the .md page
+  s|(/context/api-propagators.md)#propagators-api|$1|g;
+  s|(/semantic_conventions/faas.md)#function-as-a-service|$1|g;
+  s/#log-data-model/./;
+
+  # s|(\w+)\.md\b|/$1|g;
+  # next if /^\s*<!--/;
+  s|\bREADME.md\b|_index.md|g;
+
+  # Rewrite inline links
+  s|\]\(([^:\)]*?\.md(#.*?)?)\)|]({{< relref "$1" >}})|g;
+  
+  # Rewrite link defs (TODO: enforce at least one space after colon)
+  s|^(\[[^\]]+\]:\s*)([^:\s]*)(\s*(\(.*\))?)$|$1\{{< relref "$2" >}}$3|g;
+
+  print;
+}
\ No newline at end of file
diff --git a/scripts/cp-spec-pages.sh b/scripts/cp-spec-pages.sh
new file mode 100755
index 000000000000..d8af8d687411
--- /dev/null
+++ b/scripts/cp-spec-pages.sh
@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+BASE_DIR=$(dirname $0)
+SPEC=content-modules/opentelemetry-specification/specification
+DEST=content/en/docs/specification
+
+# set -x
+
+rm -Rf $DEST/[^_]*
+
+# cp $SPEC/overview.md $DEST
+cp -R $SPEC/* $DEST/
+
+find $DEST/ -name "README.md" -exec sh -c 'f="{}"; mv -- "$f" "${f%README.md}_index.md"' \;
+
+FILES=`find $DEST -name "*.md" | grep -ve 'specification/_index.md$'`
+$BASE_DIR/adjust-spec-pages.pl $FILES
+
+echo "Specification pages copied."

From 758f737e54c85cee18275f06a267441bffebe0fb Mon Sep 17 00:00:00 2001
From: Patrice Chalin <pchalin@gmail.com>
Date: Wed, 27 Oct 2021 16:02:08 -0400
Subject: [PATCH 2/9] Add base mount point for static/img

---
 config.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/config.yaml b/config.yaml
index 3c747080e8f1..454c931ae8bd 100644
--- a/config.yaml
+++ b/config.yaml
@@ -159,5 +159,7 @@ module:
       target: static
     - source: content-modules/opentelemetry-specification/schemas
       target: static/schemas
+    - source: static/img
+      target: static/img
     - source: content-modules/opentelemetry-specification/internal/img
       target: static/img

From 7e4941b5e23ab96f933873b14069609d41b350b1 Mon Sep 17 00:00:00 2001
From: Patrice Chalin <pchalin@gmail.com>
Date: Thu, 28 Oct 2021 10:39:52 -0400
Subject: [PATCH 3/9] Script cleanup, no change in behavior

---
 scripts/adjust-spec-pages.pl | 16 +++++-----------
 scripts/cp-spec-pages.sh     |  5 +----
 2 files changed, 6 insertions(+), 15 deletions(-)

diff --git a/scripts/adjust-spec-pages.pl b/scripts/adjust-spec-pages.pl
index 17ea8729cc88..1d7a014d6122 100755
--- a/scripts/adjust-spec-pages.pl
+++ b/scripts/adjust-spec-pages.pl
@@ -1,4 +1,4 @@
-#!/usr/bin/perl -w -i 
+#!/usr/bin/perl -w -i
 
 $^W = 1;
 
@@ -13,12 +13,10 @@
 my $semConvRef = 'https://github.com/open-telemetry/opentelemetry-specification/blob/main/semantic_conventions/README.md';
 
 sub printTitle() {
-
   print "---\n";
   print "title: $title\n";
   print "weight: 1\n" if $title eq "Overview";
   ($linkTitle) = $title =~ /^OpenTelemetry (.*)/;
-  # ($linkTitle) = $linkTitle =~ /^Metrics (.*)/;
   $linkTitle = 'FaaS' if $ARGV =~ /faas-metrics.md$/;
   $linkTitle = 'HTTP' if $ARGV =~ /http-metrics.md$/;
   print "linkTitle: $linkTitle\n" if $linkTitle;
@@ -26,9 +24,7 @@ ()
 }
 
 sub skipDetailsOrToc() {
-  while(<>) {
-    last if /<\/details>|<!-- tocstop/;
-  }
+  while(<>) { last if /<\/details>|<!-- tocstop/; }
 }
 
 # main
@@ -55,7 +51,7 @@ ()
 
   # Bug fix from original source
   s/#(#(instrument|set-status))/$1/;
-  
+
   # Images
   s|(\.\./)?internal(/img/[-\w]+\.png)|$2|g;
   s|(\]\()(img/.*?\))|$1../$2|g;
@@ -65,14 +61,12 @@ ()
   s|(/semantic_conventions/faas.md)#function-as-a-service|$1|g;
   s/#log-data-model/./;
 
-  # s|(\w+)\.md\b|/$1|g;
-  # next if /^\s*<!--/;
   s|\bREADME.md\b|_index.md|g;
 
   # Rewrite inline links
   s|\]\(([^:\)]*?\.md(#.*?)?)\)|]({{< relref "$1" >}})|g;
-  
-  # Rewrite link defs (TODO: enforce at least one space after colon)
+
+  # Rewrite link defs
   s|^(\[[^\]]+\]:\s*)([^:\s]*)(\s*(\(.*\))?)$|$1\{{< relref "$2" >}}$3|g;
 
   print;
diff --git a/scripts/cp-spec-pages.sh b/scripts/cp-spec-pages.sh
index d8af8d687411..8f8804ebad05 100755
--- a/scripts/cp-spec-pages.sh
+++ b/scripts/cp-spec-pages.sh
@@ -4,11 +4,8 @@ BASE_DIR=$(dirname $0)
 SPEC=content-modules/opentelemetry-specification/specification
 DEST=content/en/docs/specification
 
-# set -x
-
 rm -Rf $DEST/[^_]*
 
-# cp $SPEC/overview.md $DEST
 cp -R $SPEC/* $DEST/
 
 find $DEST/ -name "README.md" -exec sh -c 'f="{}"; mv -- "$f" "${f%README.md}_index.md"' \;
@@ -16,4 +13,4 @@ find $DEST/ -name "README.md" -exec sh -c 'f="{}"; mv -- "$f" "${f%README.md}_in
 FILES=`find $DEST -name "*.md" | grep -ve 'specification/_index.md$'`
 $BASE_DIR/adjust-spec-pages.pl $FILES
 
-echo "Specification pages copied."
+echo "Specification pages copied and processed."

From 2552737bb2f7c5d306855b82d9960d6552e93dd5 Mon Sep 17 00:00:00 2001
From: Patrice Chalin <pchalin@gmail.com>
Date: Fri, 29 Oct 2021 04:35:33 -0400
Subject: [PATCH 4/9] Fix markdown link reference

---
 content/en/docs/specification/_index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/en/docs/specification/_index.md b/content/en/docs/specification/_index.md
index af80706deb6d..9b514dc14960 100644
--- a/content/en/docs/specification/_index.md
+++ b/content/en/docs/specification/_index.md
@@ -66,7 +66,7 @@ Conversely, an implementation of the [specification](overview) is compliant if i
 
 ## Versioning the Specification
 
-Changes to the [specification](overview) are versioned according to [Semantic Versioning 2.0](https://semver.org/spec/v2.0.0.html) and described in [CHANGELOG][]. Layout changes are not versioned. Specific implementations of the specification should specify which version they implement.
+Changes to the [specification](overview) are versioned according to [Semantic Versioning 2.0](https://semver.org/spec/v2.0.0.html) and described in [CHANGELOG.md][]. Layout changes are not versioned. Specific implementations of the specification should specify which version they implement.
 
 Changes to the change process itself are not currently versioned but may be independently versioned in the future.
 

From a0d78422fd44f49103b84d9b9b76ca494ff2eb55 Mon Sep 17 00:00:00 2001
From: Patrice Chalin <pchalin@gmail.com>
Date: Fri, 29 Oct 2021 10:36:58 -0400
Subject: [PATCH 5/9] Support repo links to spec repo

---
 content/en/docs/specification/_index.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/content/en/docs/specification/_index.md b/content/en/docs/specification/_index.md
index 9b514dc14960..b1bb623c60ad 100644
--- a/content/en/docs/specification/_index.md
+++ b/content/en/docs/specification/_index.md
@@ -1,6 +1,16 @@
 ---
 title: Specification
 no_list: true
+cascade:
+  github_repo: &repo https://github.com/open-telemetry/opentelemetry-specification
+  github_subdir: specification
+  path_base_for_github_subdir: content/en/docs/specification/
+  github_project_repo: *repo
+# Keep global values for this page. TODO: eliminate these overrides by moving the page into the spec repo.
+github_repo: &repo https://github.com/open-telemetry/opentelemetry.io
+github_subdir: ''
+path_base_for_github_subdir: ''
+github_project_repo: *repo
 weight: 2
 ---
 

From 74a0faf1e343644a719791656a05606187b9d9cd Mon Sep 17 00:00:00 2001
From: Patrice Chalin <pchalin@gmail.com>
Date: Fri, 29 Oct 2021 10:39:42 -0400
Subject: [PATCH 6/9] Remove GitHub tag, since it might not match the file
 version

---
 content/en/docs/specification/_index.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/content/en/docs/specification/_index.md b/content/en/docs/specification/_index.md
index b1bb623c60ad..eef2d29a4250 100644
--- a/content/en/docs/specification/_index.md
+++ b/content/en/docs/specification/_index.md
@@ -14,8 +14,6 @@ github_project_repo: *repo
 weight: 2
 ---
 
-![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/open-telemetry/specification.svg)
-
 The OpenTelemetry specification describes the cross-language requirements and expectations for all OpenTelemetry implementations. Substantive changes to the specification must be proposed using the [OpenTelemetry Enhancement Proposal](https://github.com/open-telemetry/oteps) process. Small changes, such as clarifications, wording changes, spelling/grammar corrections, etc. can be made directly via pull requests.
 
 Questions that needs additional attention can be brought to the regular

From cd0ca5317c826adb6cfcd53c389fe83208bbfacd Mon Sep 17 00:00:00 2001
From: Patrice Chalin <pchalin@gmail.com>
Date: Fri, 29 Oct 2021 10:44:58 -0400
Subject: [PATCH 7/9] Support repo links via page rename for index to README

---
 scripts/adjust-spec-pages.pl | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/scripts/adjust-spec-pages.pl b/scripts/adjust-spec-pages.pl
index 1d7a014d6122..0595a61321d8 100755
--- a/scripts/adjust-spec-pages.pl
+++ b/scripts/adjust-spec-pages.pl
@@ -20,6 +20,11 @@ ()
   $linkTitle = 'FaaS' if $ARGV =~ /faas-metrics.md$/;
   $linkTitle = 'HTTP' if $ARGV =~ /http-metrics.md$/;
   print "linkTitle: $linkTitle\n" if $linkTitle;
+  if ($ARGV =~ /_index.md$/) {
+    print "path_base_for_github_subdir:\n";
+    print "  from: content/en/docs/specification/(.*?)/_index.md\n";
+    print "  to: \$1/README.md\n";
+  }
   print "---\n";
 }
 

From 35bab5e47d1500cfa353a7d52e93418fc1553d4d Mon Sep 17 00:00:00 2001
From: Patrice Chalin <pchalin@gmail.com>
Date: Tue, 2 Nov 2021 11:10:13 -0400
Subject: [PATCH 8/9] Move spec to be below /reference

---
 .gitignore                                              | 6 +++---
 content/en/docs/reference/_index.md                     | 5 +++++
 content/en/docs/{ => reference}/specification/_index.md | 2 +-
 scripts/cp-spec-pages.sh                                | 2 +-
 4 files changed, 10 insertions(+), 5 deletions(-)
 create mode 100644 content/en/docs/reference/_index.md
 rename content/en/docs/{ => reference}/specification/_index.md (98%)

diff --git a/.gitignore b/.gitignore
index b57217bcf2a7..e01c73c60fd5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -19,6 +19,6 @@ assets/jsconfig.json
 *.iml
 
 # Generated content
-/content/en/docs/specification/**/*.md
-/content/en/docs/specification/**/*.png
-!/content/en/docs/specification/_index.md
+/content/en/docs/reference/specification/**/*.md
+/content/en/docs/reference/specification/**/*.png
+!/content/en/docs/reference/specification/_index.md
diff --git a/content/en/docs/reference/_index.md b/content/en/docs/reference/_index.md
new file mode 100644
index 000000000000..87abd2077c70
--- /dev/null
+++ b/content/en/docs/reference/_index.md
@@ -0,0 +1,5 @@
+---
+title: Reference
+weight: 100
+description: Reference material
+---
diff --git a/content/en/docs/specification/_index.md b/content/en/docs/reference/specification/_index.md
similarity index 98%
rename from content/en/docs/specification/_index.md
rename to content/en/docs/reference/specification/_index.md
index eef2d29a4250..c303031bfd90 100644
--- a/content/en/docs/specification/_index.md
+++ b/content/en/docs/reference/specification/_index.md
@@ -4,7 +4,7 @@ no_list: true
 cascade:
   github_repo: &repo https://github.com/open-telemetry/opentelemetry-specification
   github_subdir: specification
-  path_base_for_github_subdir: content/en/docs/specification/
+  path_base_for_github_subdir: content/en/docs/reference/specification/
   github_project_repo: *repo
 # Keep global values for this page. TODO: eliminate these overrides by moving the page into the spec repo.
 github_repo: &repo https://github.com/open-telemetry/opentelemetry.io
diff --git a/scripts/cp-spec-pages.sh b/scripts/cp-spec-pages.sh
index 8f8804ebad05..5f5cc2b6d56c 100755
--- a/scripts/cp-spec-pages.sh
+++ b/scripts/cp-spec-pages.sh
@@ -2,7 +2,7 @@
 
 BASE_DIR=$(dirname $0)
 SPEC=content-modules/opentelemetry-specification/specification
-DEST=content/en/docs/specification
+DEST=content/en/docs/reference/specification
 
 rm -Rf $DEST/[^_]*
 

From 1c388eb4320a22024d51ef86a886f724810f8bf3 Mon Sep 17 00:00:00 2001
From: Patrice Chalin <pchalin@gmail.com>
Date: Thu, 4 Nov 2021 11:11:58 -0400
Subject: [PATCH 9/9] Replace Edit-page by View-page

---
 assets/scss/_styles_project.scss              |  5 ++
 .../en/docs/reference/specification/_index.md |  1 +
 i18n/en.toml                                  |  4 +-
 layouts/docs/baseof.html                      | 34 ++++++++++++
 layouts/partials/page-meta-links.html         | 54 +++++++++++++++++++
 5 files changed, 96 insertions(+), 2 deletions(-)
 create mode 100644 layouts/docs/baseof.html
 create mode 100644 layouts/partials/page-meta-links.html

diff --git a/assets/scss/_styles_project.scss b/assets/scss/_styles_project.scss
index 6978696414c0..35da263a9eb5 100644
--- a/assets/scss/_styles_project.scss
+++ b/assets/scss/_styles_project.scss
@@ -134,3 +134,8 @@ a:hover {
     margin-bottom: initial;
   }
 }
+
+.td-page-meta--child { display: none !important; }
+.otel-docs-spec {
+  .td-page-meta--edit { display: none !important; }
+}
diff --git a/content/en/docs/reference/specification/_index.md b/content/en/docs/reference/specification/_index.md
index c303031bfd90..da779de89c7b 100644
--- a/content/en/docs/reference/specification/_index.md
+++ b/content/en/docs/reference/specification/_index.md
@@ -2,6 +2,7 @@
 title: Specification
 no_list: true
 cascade:
+  body_class: otel-docs-spec
   github_repo: &repo https://github.com/open-telemetry/opentelemetry-specification
   github_subdir: specification
   path_base_for_github_subdir: content/en/docs/reference/specification/
diff --git a/i18n/en.toml b/i18n/en.toml
index 6ec33488b0cc..a3781b4e3e0e 100644
--- a/i18n/en.toml
+++ b/i18n/en.toml
@@ -1,8 +1,8 @@
+[post_view_this]
+other = "View page source"
 [Submit]
 other = "Submit"
-
 [Reset]
 other = "Reset"
-
 [Search]
 other = "Search"
diff --git a/layouts/docs/baseof.html b/layouts/docs/baseof.html
new file mode 100644
index 000000000000..b0f269c65d8a
--- /dev/null
+++ b/layouts/docs/baseof.html
@@ -0,0 +1,34 @@
+{{/* docsy-delta */ -}}
+
+<!doctype html>
+<html lang="{{ .Site.Language.Lang }}" class="no-js">
+  <head>
+    {{ partial "head.html" . }}
+  </head>
+  <body class="td-{{ .Kind }}{{ with .Params.body_class }} {{.}}{{ end }}">
+    <header>
+      {{ partial "navbar.html" . }}
+    </header>
+    <div class="container-fluid td-outer">
+      <div class="td-main">
+        <div class="row flex-xl-nowrap">
+          <aside class="col-12 col-md-3 col-xl-2 td-sidebar d-print-none">
+            {{ partial "sidebar.html" . }}
+          </aside>
+          <aside class="d-none d-xl-block col-xl-2 td-sidebar-toc d-print-none">
+            {{ partial "page-meta-links.html" . }}
+            {{ partial "toc.html" . }}
+            {{ partial "taxonomy_terms_clouds.html" . }}
+          </aside>
+          <main class="col-12 col-md-9 col-xl-8 pl-md-5" role="main">
+            {{ partial "version-banner.html" . }}
+            {{ if not .Site.Params.ui.breadcrumb_disable }}{{ partial "breadcrumb.html" . }}{{ end }}
+            {{ block "main" . }}{{ end }}
+          </main>
+        </div>
+      </div>
+      {{ partial "footer.html" . }}
+    </div>
+    {{ partial "scripts.html" . }}
+  </body>
+</html>
\ No newline at end of file
diff --git a/layouts/partials/page-meta-links.html b/layouts/partials/page-meta-links.html
new file mode 100644
index 000000000000..d5eb3889a537
--- /dev/null
+++ b/layouts/partials/page-meta-links.html
@@ -0,0 +1,54 @@
+{{/* docsy-delta */ -}}
+{{ if .Path }}
+{{ $pathFormatted := replace .Path "\\" "/" -}}
+{{ $gh_repo := ($.Param "github_repo") -}}
+{{ $gh_url := ($.Param "github_url") -}}
+{{ $gh_subdir := ($.Param "github_subdir") -}}
+{{ $gh_project_repo := ($.Param "github_project_repo") -}}
+{{ $gh_branch := (default "master" ($.Param "github_branch")) -}}
+<div class="td-page-meta ml-2 pb-1 pt-2 mb-0">
+{{ if $gh_url -}}
+  <a href="{{ $gh_url }}" target="_blank"><i class="fa fa-edit fa-fw"></i> {{ T "post_edit_this" }}</a>
+{{ else if $gh_repo -}}
+  {{ $gh_repo_path := printf "%s/content/%s" $gh_branch $pathFormatted -}}
+  {{ if and ($gh_subdir) (.Site.Language.Lang) -}}
+    {{ $gh_repo_path = printf "%s/%s/content/%s/%s" $gh_branch $gh_subdir ($.Site.Language.Lang) $pathFormatted -}}
+  {{ else if .Site.Language.Lang -}}
+    {{ $gh_repo_path = printf "%s/content/%s/%s" $gh_branch ($.Site.Language.Lang) $pathFormatted -}}
+  {{ else if $gh_subdir -}}
+    {{ $gh_repo_path = printf "%s/%s/content/%s" $gh_branch $gh_subdir $pathFormatted -}}
+  {{ end -}}
+
+  {{/* Adjust $gh_repo_path based on path_base_for_github_subdir */ -}}
+  {{ $ghs_base := $.Param "path_base_for_github_subdir" -}}
+  {{ $ghs_rename := "" -}}
+  {{ if reflect.IsMap $ghs_base -}}
+    {{ $ghs_rename = $ghs_base.to -}}
+    {{ $ghs_base = $ghs_base.from -}}
+  {{ end -}}
+  {{ with $ghs_base -}}
+    {{ $gh_repo_path = replaceRE . $ghs_rename $gh_repo_path -}}
+  {{ end -}}
+
+  {{ $viewURL := printf "%s/tree/%s" $gh_repo $gh_repo_path -}}
+  {{ $editURL := printf "%s/edit/%s" $gh_repo $gh_repo_path -}}
+  {{ $issuesURL := printf "%s/issues/new?title=%s" $gh_repo (safeURL $.Title ) -}}
+  {{ $newPageStub := resources.Get "stubs/new-page-template.md" -}}
+  {{ $newPageQS := querify "value" $newPageStub.Content "filename" "change-me.md" | safeURL -}}
+  {{ $newPageURL := printf "%s/new/%s?%s"  $gh_repo $gh_repo_path $newPageQS -}}
+
+  <a href="{{ $viewURL }}" class="td-page-meta--view" target="_blank" rel="noopener"><i class="fa fa-file-alt fa-fw"></i> {{ T "post_view_this" }}</a>
+  <a href="{{ $editURL }}" class="td-page-meta--edit" target="_blank" rel="noopener"><i class="fa fa-edit fa-fw"></i> {{ T "post_edit_this" }}</a>
+  <a href="{{ $newPageURL }}" class="td-page-meta--child" target="_blank" rel="noopener"><i class="fa fa-edit fa-fw"></i> {{ T "post_create_child_page" }}</a>
+  <a href="{{ $issuesURL }}" class="td-page-meta--issue" target="_blank" rel="noopener"><i class="fab fa-github fa-fw"></i> {{ T "post_create_issue" }}</a>
+  {{ with $gh_project_repo -}}
+    {{ $project_issueURL := printf "%s/issues/new" . -}}
+    <a href="{{ $project_issueURL }}" class="td-page-meta--project-issue" target="_blank" rel="noopener"><i class="fas fa-tasks fa-fw"></i> {{ T "post_create_project_issue" }}</a>
+  {{ end -}}
+
+{{ end -}}
+{{ with .CurrentSection.AlternativeOutputFormats.Get "print" -}}
+  <a id="print" href="{{ .Permalink | safeURL }}"><i class="fa fa-print fa-fw"></i> {{ T "print_entire_section" }}</a>
+{{ end }}
+</div>
+{{ end -}}