Specification: rework of how the spec is generated, and link fix (ope…

…n-telemetry#1152)

.gitignore

@@ -14,11 +14,6 @@ tmp/
 scripts/collector.yaml
 assets/jsconfig.json
 
-# Generated content
-/content/en/docs/reference/specification/**/*.md
-/content/en/docs/reference/specification/**/*.png
-!/content/en/docs/reference/specification/_index.md
-
 # IntelliJ
 *.iml
 

config.yaml

@@ -146,6 +146,8 @@ params:
 
 module:
   mounts:
+    - source: tmp/specification
+      target: content/docs/reference/specification
     - source: content/en
       target: content
     - source: static

scripts/adjust-spec-pages.pl

@@ -68,6 +68,7 @@ ()
   s|(/semantic_conventions/faas.md)#function-as-a-service|$1|g;
   s/#log-data-model/./;
 
+  s|\.\.\/README.md\b|..| if $ARGV =~ /specification.library-guidelines.md/;
   s|\bREADME.md\b|_index.md|g;
 
   # Rewrite inline links

scripts/cp-spec-pages.sh

@@ -2,10 +2,10 @@
 
 BASE_DIR=$(dirname $0)
 SPEC=content-modules/opentelemetry-specification/specification
-DEST=content/en/docs/reference/specification
-
-git clean -xdf $DEST > /dev/null
+DEST=tmp/specification
 
+rm -Rf $DEST
+mkdir -p $DEST
 cp -R $SPEC/* $DEST/
 
 find $DEST/ -name "README.md" -exec sh -c 'f="{}"; mv -- "$f" "${f%README.md}_index.md"' \;