fix(semconv): correct & simplify codegen templates

[robbkidd]

• Update rendering of deprecation notes for deprecated attributes/metrics

The data under this key is now a dict. .note is informative when present, but isn't always, so fallback to .reason.

• Remove @example blocks

Yard @example content needs to be indented within the code comment in a tricksy way. Combine that with the variety of shapes the data under .examples is provided and the template becomes complicated and brittle.

WWJD: What Would Java Do? - They don't include .examples in their generated semantic conventions code. So let's not also.

[robbkidd]

Per my usual, walking the commits is intended to make review more straightforward.

[robbkidd]

Spellcheck failure is on content generated from semconv source models. 😐

[kaylareopelle]

Spellcheck failure is on content generate from semconv source models. 😐

It'll be fixed for future versions 🎉 open-telemetry/semantic-conventions#3549

[kaylareopelle]

This is great! Thank you! Would you mind adding something to either the README or the Rake task output to let folks know the task isn't bumping the version anymore? We can pull it out if/when we get back to full automation.

[robbkidd]

@kaylareopelle Updated words!

Example output from the rake task:

❯ rake update_spec_version_constant

+++ Updating library SPEC_VERSION constant to 1.37.0.
    ℹ️  VERSION is managed by release automation and left unchanged.
sed -i.bak "s/SPEC_VERSION = '.*'/SPEC_VERSION = '1.37.0'/g" lib/opentelemetry/semantic_conventions/version.rb
rm lib/opentelemetry/semantic_conventions/version.rb.bak

---

🔍 👀

Update: There are two spaces between ℹ️ and VERSION. I put two in because output on my terminal seemed to swallow one space, but they both appear here even though I copied that content from my terminal. How do fonts even? I'm happy to remove that second space or leave it.

[kaylareopelle]

@kaylareopelle Updated words!

Example output from the rake task:

❯ rake update_spec_version_constant

+++ Updating library SPEC_VERSION constant to 1.37.0.
    ℹ️  VERSION is managed by release automation and left unchanged.
sed -i.bak "s/SPEC_VERSION = '.*'/SPEC_VERSION = '1.37.0'/g" lib/opentelemetry/semantic_conventions/version.rb
rm lib/opentelemetry/semantic_conventions/version.rb.bak

🔍 👀

Update: There are two spaces between ℹ️ and VERSION. I put two in because output on my terminal seemed to swallow one space, but they both appear here even though I copied that content from my terminal. How do fonts even? I'm happy to remove that second space or leave it.

Thanks for the update! I think it looks great as-is. We can go back and fix it if it bugs us.