Update semantic-conventions

[chalin]

• Contributes to Adjust to move Semantic Conventions out of OTel spec #2721
• Updates semantic-conventions under /docs/specs/semconv using the new organization brought in by Renamed specification and semantic_conventions to model and docs semantic-conventions#166

IMPORTANT NOTE: if this PR is merged, then the semantic-conventions will be published to the production server. Are y'all ok with that @jsuereth @joaopgrassi @open-telemetry/specs-semconv-approvers?

Preview: https://deploy-preview-2982--opentelemetry.netlify.app/docs/specs/semconv/

[chalin]

FYI, I'm working on fixing links. Wanted to get the preview out ASAP.

[jsuereth]

If it helps, I had a few of my own link fixed here: https://github.com/jsuereth/opentelemetry.io/pull/new/wip-bump-semconv

[chalin]

If it helps, I had a few of my own link fixed here: https://github.com/jsuereth/opentelemetry.io/pull/new/wip-bump-semconv

All done, thanks!

[chalin]

Oh cool, you actually added custom frontmatter @jsuereth! Ok, let me use that too!

[chalin]

There will be followup PRs, but this is ready to go @jsuereth.
Do we need any more approvals, or can this be merged?

[chalin]

@jsuereth - if you agree to this being merged, please acknowledge that you've read the IMPORTANT NOTE in the opening comment, and agree with the semconv pages being published.

[chalin]

A few fixes that should land before the semconv pages are published:

• Consistent page title form and capitalization semantic-conventions#169
• [editorial] Add missing README.md for Resource Cloud Provider semconv semantic-conventions#171
• Docs file and folder names should consistently be in kebabe-case rather than snake_case semantic-conventions#172

[joaopgrassi]

Giving my approval on the general website structure for the semconv. Looks really nice!

[jsuereth]

@chalin I'd like to actually only publish a stable tag to the website if we can (and make sure the website shows that stable version). Is there more work required to do that?

Given how the website looks with this PR though, I'm comfortable removing this as a blocker for releasing the semconv repository and then we can update this to pull in that known version.

[jsuereth]

Also wanted to comment, if you'd like to publish this now and add in a version as soon as we have our first release, I'm also ok with that timing.

[chalin]

@chalin I'd like to actually only publish a stable tag ...

@jsuereth - Ok, here's what I've done: I've kept the draft status for the semconv pages. That means that they won't appear on the production server yet. That'll give us time to address the issues I've raised over the semconv repo.

Once the build is green, since this PR has your and other approvals, I'll merge.

[jsuereth]

Thanks for all the hard work @chalin ! This is really looking great!