Updated Zipkin spec for remoteEndpoint mapping.

.circleci/config.yml

@@ -4,27 +4,35 @@ version: 2
 jobs:
   misspell:
     docker:
-      - image: circleci/golang:1.12
+      - image: circleci/golang:1.14
     steps:
       - checkout
+      - run:
+          name: Misspell Install
+          command: make install-misspell
       - run:
           name: Misspell check
-          command: make precommit
+          command: make misspell
+
   markdownlint:
     docker:
-      - image: circleci/ruby:latest
+      - image: node:13
     steps:
       - checkout
       - run:
-          name: Install markdownlint
-          command: gem install mdl
+          name: Install Tools
+          command: |
+            make install-markdown-lint
+            make install-markdown-link-check
       - run:
-          name: Check markdownlint
-          command: mdl -c .mdlrc .
+          name: Run Tools
+          command: |
+            make markdown-lint
+            make markdown-link-check
 
 workflows:
   version: 2
-  build:
+  check-errors:
     jobs:
       - misspell
       - markdownlint

.github/CODEOWNERS

@@ -0,0 +1,28 @@
+#####################################################
+#
+# List of approvers for OpenTelemetry Specifications repository
+#
+#####################################################
+#
+# Learn about membership in OpenTelemetry community:
+#  https://github.com/open-telemetry/community/blob/master/community-membership.md
+# 
+#
+# Learn about CODEOWNERS file format: 
+#  https://help.github.com/en/articles/about-code-owners
+#
+
+# Global owners, will be the owners for everything in the repo. Membership is tracked via https://github.com/open-telemetry/community/blob/master/community-members.md 
+*   @open-telemetry/technical-committee @open-telemetry/specs-approvers
+
+# Trace owners (global + trace)
+experimental/trace/     @open-telemetry/technical-committee @open-telemetry/specs-approvers @open-telemetry/specs-trace-approvers
+specification/trace/    @open-telemetry/technical-committee @open-telemetry/specs-approvers @open-telemetry/specs-trace-approvers
+
+# Metrics owners (global + metrics)
+experimental/metrics/   @open-telemetry/technical-committee @open-telemetry/specs-approvers @open-telemetry/specs-metrics-approvers
+specification/metrics/  @open-telemetry/technical-committee @open-telemetry/specs-approvers @open-telemetry/specs-metrics-approvers
+
+# Logs owners (global + logs)
+experimental/logs/      @open-telemetry/technical-committee @open-telemetry/specs-approvers @open-telemetry/specs-logs-approvers
+specification/logs/     @open-telemetry/technical-committee @open-telemetry/specs-approvers @open-telemetry/specs-logs-approvers

.github/ISSUE_TEMPLATE/context.md

@@ -0,0 +1,13 @@
+---
+name: Context
+about: Issues related to the specification/context directory
+labels: spec:context
+---
+
+**What are you trying to achieve?**
+
+What did you expect to see?
+
+**Additional context.**
+
+Add any other context about the problem here. If you followed an existing documentation, please share the link to it.

.github/ISSUE_TEMPLATE/correlationcontext.md

@@ -0,0 +1,13 @@
+---
+name: CorrelationContext
+about: Issues related to the specification/correlationcontext directory
+labels: spec:correlationcontext
+---
+
+**What are you trying to achieve?**
+
+What did you expect to see?
+
+**Additional context.**
+
+Add any other context about the problem here. If you followed an existing documentation, please share the link to it.

.github/ISSUE_TEMPLATE/logs.md

@@ -0,0 +1,13 @@
+---
+name: Logs
+about: Issues related to the specification/logs directory
+labels: spec:logs
+---
+
+**What are you trying to achieve?**
+
+What did you expect to see?
+
+**Additional context.**
+
+Add any other context about the problem here. If you followed an existing documentation, please share the link to it.

.github/ISSUE_TEMPLATE/metrics.md

@@ -0,0 +1,13 @@
+---
+name: Metrics
+about: Issues related to the specification/metrics directory
+labels: spec:metrics
+---
+
+**What are you trying to achieve?**
+
+What did you expect to see?
+
+**Additional context.**
+
+Add any other context about the problem here. If you followed an existing documentation, please share the link to it.

.github/ISSUE_TEMPLATE/miscellaneous.md

@@ -0,0 +1,13 @@
+---
+name: Miscellaneous (anything else)
+about: Issues that do not fit into other categories
+labels: spec:miscellaneous
+---
+
+**What are you trying to achieve?**
+
+What did you expect to see?
+
+**Additional context.**
+
+Add any other context about the problem here. If you followed an existing documentation, please share the link to it.

.github/ISSUE_TEMPLATE/protocol.md

@@ -0,0 +1,13 @@
+---
+name: Protocol
+about: Issues related to the specification/protocol directory
+labels: spec:protocol
+---
+
+**What are you trying to achieve?**
+
+What did you expect to see?
+
+**Additional context.**
+
+Add any other context about the problem here. If you followed an existing documentation, please share the link to it.

.github/ISSUE_TEMPLATE/resource.md

@@ -0,0 +1,13 @@
+---
+name: Resource
+about: Issues related to the specification/resource directory
+labels: spec:resource
+---
+
+**What are you trying to achieve?**
+
+What did you expect to see?
+
+**Additional context.**
+
+Add any other context about the problem here. If you followed an existing documentation, please share the link to it.

.github/ISSUE_TEMPLATE/trace.md

@@ -0,0 +1,13 @@
+---
+name: Trace
+about: Issues related to the specification/trace directory
+labels: spec:trace
+---
+
+**What are you trying to achieve?**
+
+What did you expect to see?
+
+**Additional context.**
+
+Add any other context about the problem here. If you followed an existing documentation, please share the link to it.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,9 @@
+Fixes #
+
+## Changes
+
+Please provide a brief description of the changes here.
+
+Related issues #
+
+Related [oteps](https://github.com/open-telemetry/oteps) #

.github/workflows/docfx.yml

@@ -0,0 +1,20 @@
+name: docfx
+
+on:
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+    runs-on: windows-latest
+
+    steps:
+    - name: check out code
+      uses: actions/checkout@v2
+
+    - name: install docfx
+      run: choco install docfx -y
+
+    - name: run .\docfx.cmd
+      shell: cmd
+      run: .\docfx.cmd

.github/workflows/state-pr.yaml

@@ -0,0 +1,17 @@
+name: "Close stale pull requests"
+on:
+  schedule:
+    - cron: "12 3 * * *" # arbitrary time not to DDOS GitHub
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/stale@v3
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-pr-message: 'This PR was marked stale due to lack of activity. It will be closed in 7 days.'
+        close-pr-message: 'Closed as inactive. Feel free to reopen if this PR is still being worked on.'
+        days-before-stale: 14
+        days-before-close: 7
+        debug-only: true

.markdown_link_check_config.json

@@ -0,0 +1,7 @@
+{
+  "ignorePatterns": [
+      {
+          "pattern": "^https://github\\.com"
+      }
+  ]
+}

.markdownlint.yaml

@@ -0,0 +1,9 @@
+{
+  "default": true,
+  "MD024": { "allow_different_nesting": true },
+  "MD029": { "style": "ordered" },
+  "ul-style": false,  # MD004
+  "line-length": false,  # MD013
+  "no-inline-html": false,  # MD033
+  "fenced-code-language": false  # MD040
+}

.vs/ProjectSettings.json

@@ -0,0 +1,3 @@
+{
+  "CurrentProjectSetting": null
+}

.vs/VSWorkspaceState.json

@@ -0,0 +1,8 @@
+{
+  "ExpandedNodes": [
+    "",
+    "\\specification"
+  ],
+  "SelectedNode": "\\specification\\exporter-zipkin.md",
+  "PreviewInSolutionExplorer": false
+}

CHANGELOG.md

@@ -7,13 +7,86 @@ the release.
 
 ## Unreleased
 
+New:
+
+- Add resource semantic conventions for operating systems ([#693](https://github.com/open-telemetry/opentelemetry-specification/pull/693))
+
+Updates:
+
+- Add semantic convention for NGINX custom HTTP 499 status code.
+- Adapt semantic conventions for the span name of messaging systems ([#690](https://github.com/open-telemetry/opentelemetry-specification/pull/690))
+- Provide clear definitions for readable and read/write span interfaces in the SDK ([#669](https://github.com/open-telemetry/opentelemetry-specification/pull/669))
+  * SpanProcessors must provide read/write access at least in OnStart.
+- Specify how `Probability` sampler is used with `ParentOrElse` sampler.
+- Clean up api-propagators.md, by extending documentation and removing redundant sections ([#577](https://github.com/open-telemetry/opentelemetry-specification/pull/577))
+
+## v0.6.0 (07-01-2020)
+
+New:
+
+- Add span attribute to indicate cold starts of Function as a Service executions ([#650](https://github.com/open-telemetry/opentelemetry-specification/pull/650))
+- Add conventions for naming of exporter packages ([#629](https://github.com/open-telemetry/opentelemetry-specification/pull/629))
+- Add semantic conventions for container id ([#673](https://github.com/open-telemetry/opentelemetry-specification/pull/673))
+- Add semantic conventions for HTTP content length ([#641](https://github.com/open-telemetry/opentelemetry-specification/pull/641))
+- Add semantic conventions for process resource ([#635](https://github.com/open-telemetry/opentelemetry-specification/pull/635))
+- Add peer.service to provide a user-configured name for a remote service ([#652](https://github.com/open-telemetry/opentelemetry-specification/pull/652))
+
+Updates:
+
+- Improve root Span description ([#645](https://github.com/open-telemetry/opentelemetry-specification/pull/645))
+- Extend semantic conventions for RPC and allow non-gRPC calls ([#604](https://github.com/open-telemetry/opentelemetry-specification/pull/604))
+- Revise and extend semantic conventions for databases ([#575](https://github.com/open-telemetry/opentelemetry-specification/pull/575))
+- Clarify Tracer vs TracerProvider in tracing API and SDK spec. ([#619](https://github.com/open-telemetry/opentelemetry-specification/pull/619))
+  Most importantly:
+  * Configuration should be stored not per Tracer but in the TracerProvider.
+  * Active spans are not per Tracer.
+- Do not set any value in Context upon failed extraction ([#671](https://github.com/open-telemetry/opentelemetry-specification/pull/671))
+- Clarify semantic conventions around span start and end time ([#592](https://github.com/open-telemetry/opentelemetry-specification/pull/592))
+
+## v0.5.0 (06-02-2020)
+
+- Define Log Data Model.
+- Remove SpanId from Sampler input.
+- Clarify what it will mean for a vendor to "support OpenTelemetry".
+- Clarify Tracers should reference an InstrumentationLibrary rather than a Resource.
+- Replace ALWAYS_PARENT sampler with a composite ParentOrElse sampler.
+- Incorporate old content on metrics calling conventions, label sets.
+- Update api-metrics-user.md and api-metrics-meter.md with the latest metrics API.
+- Normalize Instrumentation term for instrumentations.
+- Change w3c correlation context to custom header.
+
+## v0.4.0 (05-12-2020)
+
+- [OTEP-83](https://github.com/open-telemetry/oteps/blob/master/text/0083-component.md) Introduce the notion of InstrumentationLibrary.
+- [OTEP-88](https://github.com/open-telemetry/oteps/blob/master/text/metrics/0088-metric-instrument-optional-refinements.md) Metrics API instrument foundation.
+- [OTEP-91](https://github.com/open-telemetry/oteps/blob/master/text/logs/0091-logs-vocabulary.md) Logs vocabulary.
+- [OTEP-92](https://github.com/open-telemetry/oteps/blob/master/text/logs/0092-logs-vision.md) Logs Vision.
+- [OTEP-90](https://github.com/open-telemetry/oteps/blob/master/text/metrics/0090-remove-labelset-from-metrics-api.md) Remove LabelSet from the metrics API.
+- [OTEP-98](https://github.com/open-telemetry/oteps/blob/master/text/metrics/0098-metric-instruments-explained.md) Explain the metric instruments.
+- [OTEP-99](https://github.com/open-telemetry/oteps/blob/master/text/0099-otlp-http.md) OTLP/HTTP: HTTP Transport Extension for OTLP.
+- Define handling of null and empty attribute values.
+- Rename Setter.put to Setter.set
+- Add glossary for typically misused terms.
+- Clarify that resources are immutable.
+- Clarify that SpanContext.IsRemote is false on remote children.
+- Move specifications into sub-directories per signal.
+- Remove references to obsolete `peer.*` attributes.
+- Span semantic conventions for for messaging systems.
+- Span semantic conventions for function as a service.
+- Remove the handling of retries from trace exporters.
+- Remove Metrics' default keys.
+- Add some clarifying language to the semantics of metric instrument naming.
+- Allow injectors and extractors to be separate interfaces.
+- Add an explanation on why Context Restore operation is needed.
+- Document special Zipkin conversion cases.
+
 ## v0.3.0 (02-21-2020)
 
-- [OTEP-0059](https://github.com/open-telemetry/oteps/blob/master/text/0059-otlp-trace-data-format.md) Add OTLP Trace Data Format specification.
+- [OTEP-0059](https://github.com/open-telemetry/oteps/blob/master/text/trace/0059-otlp-trace-data-format.md) Add OTLP Trace Data Format specification.
 - [OTEP-0066](https://github.com/open-telemetry/oteps/blob/master/text/0066-separate-context-propagation.md) Separate Layer for Context Propagation.
-- [OTEP-0070](https://github.com/open-telemetry/oteps/blob/master/text/0070-metric-bound-instrument.md) Rename metric instrument "Handles" to "Bound Instruments".
-- [OTEP-0072](https://github.com/open-telemetry/oteps/blob/master/text/0072-metric-observer.md) Metric Observer instrument specification (refinement).
-- [OTEP-0080](https://github.com/open-telemetry/oteps/blob/master/text/0080-remove-metric-gauge.md) Remove the Metric Gauge instrument, recommend use of other instruments.
+- [OTEP-0070](https://github.com/open-telemetry/oteps/blob/master/text/metrics/0070-metric-bound-instrument.md) Rename metric instrument "Handles" to "Bound Instruments".
+- [OTEP-0072](https://github.com/open-telemetry/oteps/blob/master/text/metrics/0072-metric-observer.md) Metric Observer instrument specification (refinement).
+- [OTEP-0080](https://github.com/open-telemetry/oteps/blob/master/text/metrics/0080-remove-metric-gauge.md) Remove the Metric Gauge instrument, recommend use of other instruments.
 - Update 0003-measure-metric-type to match current Specification.
 - Update 0009-metric-handles to match current Specification.
 - Clarify named tracers and meters.
@@ -33,12 +106,12 @@ the release.
 ## v0.2.0 (10-22-2019)
 
 - [OTEP-0001](https://github.com/open-telemetry/oteps/blob/master/text/0001-telemetry-without-manual-instrumentation.md) Added Auto-Instrumentation.
-- [OTEP-0002](https://github.com/open-telemetry/oteps/blob/master/text/0002-remove-spandata.md): Removed SpanData interface in favor of Span Start and End options.
-- [OTEP-0003](https://github.com/open-telemetry/oteps/blob/master/text/0003-measure-metric-type.md) Consolidatesd pre-aggregated and raw metrics APIs.
-- [OTEP-0008](https://github.com/open-telemetry/oteps/blob/master/text/0008-metric-observer.md) Added Metrics Observers API.
-- [OTEP-0009](https://github.com/open-telemetry/oteps/blob/master/text/0009-metric-handles.md) Added Metrics Handle API.
-- [OTEP-0010](https://github.com/open-telemetry/oteps/blob/master/text/0010-cumulative-to-counter.md) Rename "Cumulative" to "Counter" in the Metrics API.
-- [OTEP-006](https://github.com/open-telemetry/oteps/blob/master/text/0006-sampling.md) Moved sampling from the API tp the SDK.
+- [OTEP-0002](https://github.com/open-telemetry/oteps/blob/master/text/trace/0002-remove-spandata.md): Removed SpanData interface in favor of Span Start and End options.
+- [OTEP-0003](https://github.com/open-telemetry/oteps/blob/master/text/metrics/0003-measure-metric-type.md) Consolidatesd pre-aggregated and raw metrics APIs.
+- [OTEP-0008](https://github.com/open-telemetry/oteps/blob/master/text/metrics/0008-metric-observer.md) Added Metrics Observers API.
+- [OTEP-0009](https://github.com/open-telemetry/oteps/blob/master/text/metrics/0009-metric-handles.md) Added Metrics Handle API.
+- [OTEP-0010](https://github.com/open-telemetry/oteps/blob/master/text/metrics/0010-cumulative-to-counter.md) Rename "Cumulative" to "Counter" in the Metrics API.
+- [OTEP-006](https://github.com/open-telemetry/oteps/blob/master/text/trace/0006-sampling.md) Moved sampling from the API tp the SDK.
 - [OTEP-0007](https://github.com/open-telemetry/oteps/blob/master/text/0007-no-out-of-band-reporting.md) Moved support for out-of-band telemetry from the API to the SDK.
 - [OTEP-0016](https://github.com/open-telemetry/oteps/blob/master/text/0016-named-tracers.md) Added named providers for Tracers and Meters.
 - Added design goals and requirements for a telemetry data exchange protocol.