Some cleanup in span land.

[jkwatson]

• Clean up the SpanBuilder javadoc to match the current APIs
• Scrub mentions of canonical status code
• Deprecate the getCanonicalCode method on SpanBuilder and replace with getStatusCode

[codecov]

Codecov Report

❗ No coverage uploaded for pull request base (master@9d17c66). Click here to learn what that means.
The diff coverage is 100.00%.

@@            Coverage Diff            @@
##             master    #2062   +/-   ##
=========================================
  Coverage          ?   85.36%           
  Complexity        ?     2026           
=========================================
  Files             ?      231           
  Lines             ?     7849           
  Branches          ?      830           
=========================================
  Hits              ?     6700           
  Misses            ?      838           
  Partials          ?      311           

Impacted Files	Coverage Δ	Complexity Δ
...ava/io/opentelemetry/api/trace/PropagatedSpan.java	83.33% <ø> (ø)	18.00 <0.00> (?)
...src/main/java/io/opentelemetry/api/trace/Span.java	100.00% <ø> (ø)	17.00 <0.00> (?)
...n/java/io/opentelemetry/api/trace/SpanBuilder.java	50.00% <ø> (ø)	1.00 <0.00> (?)
...java/io/opentelemetry/exporter/jaeger/Adapter.java	97.19% <100.00%> (ø)	20.00 <0.00> (?)
...va/io/opentelemetry/exporter/otlp/SpanAdapter.java	96.11% <100.00%> (ø)	21.00 <0.00> (?)
...ntelemetry/exporter/zipkin/ZipkinSpanExporter.java	87.96% <100.00%> (ø)	30.00 <0.00> (?)
...emetry/sdk/extension/zpages/TracezSpanBuckets.java	100.00% <100.00%> (ø)	13.00 <0.00> (?)
...ntelemetry/sdk/trace/RecordEventsReadableSpan.java	84.28% <100.00%> (ø)	70.00 <4.00> (?)
.../opentelemetry/sdk/trace/data/ImmutableStatus.java	88.88% <100.00%> (ø)	6.00 <1.00> (?)
...java/io/opentelemetry/sdk/trace/data/SpanData.java	100.00% <100.00%> (ø)	0.00 <0.00> (?)
... and 231 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 9d17c66...3e10818. Read the comment docs.

[Oberon00]

I think we currently still have enough other breaking changes that it is OK to completely remove this. It's just a renaming, right?

[jkwatson]

I've started thinking that since we're moving to a 2-week release cycle, that it would be more friendly to end users to introduce deprecations that are then deleted in the following release. We discussed this at the SIG meeting this morning, and it was generally agreed to. This seemed like a easy way to ease into the practice. :)

[anuraaga]

Thanks for scrubbing!