chore: Update CONTRIBUTING with process and minor changes

[Lms24]

• Adds attribute PR approval process formerly specified in SDK dev docs
• Minor adjustments from recent changes around docs and code generation
• Minor heading level adjustments
• Attribute naming policy clarifications
• Release instructions

[github-actions]

Semver Impact of This PR

🟢 Patch (bug fixes)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

New Features ✨

Attributes

• Add app.vitals.* attributes for mobile performance by buenaflor in #313
• Add remaining app context attributes by buenaflor in #304
• Add sentry.mobile and sentry.main_thread attributes by buenaflor in #317
• Add more device context attributes by buenaflor in #303
• Add OS context attributes by buenaflor in #301
• Add gen_ai.function_id attribute by constantinius in #308
• Add gen_ai.context.window_size and gen_ai.context.utilization for generation spans by constantinius in #315
• Add db.driver.name attribute by alexander-alderman-webb in #295
• Add network connection-related attributes by Lms24 in #279
• Add cache.write attribute by adinauer in #292
• Add device context attributes by buenaflor in #300
• Add app context attributes for mobile by buenaflor in #296
• Add device memory and core count attributes by Lms24 in #281
• Add ui.element.* attributes by Lms24 in #284
• Add remaining TTFB, FCP and FP web vital attributes by Lms24 in #235
• Add LCP web vital meta attributes by Lms24 in #233
• Add CLS web vital source attribute by Lms24 in #234
• Add core web web vital value attributes by Lms24 in #229
• Add allow_any_value field to attribute schema by vgrozdanic in #272

Other

• (http) Add http.server.request.time_in_queue attribute by dingsdax in #267
• (resource) Add resource.deployment.environment by mjq in #266
• Add sentry.timestamp.sequence attribute to the spec by logaretm in #262
• Add changelog tracking to attribute definitions by ericapisani in #270

Bug Fixes 🐛

• (attributes) Remove allow_any_value boolean attribute and allow any as type by vgrozdanic in #273
• (gen_ai) Input and output token description by obostjancic in #261
• (release) Run yarn install before yarn generate in pre-release script by vgrozdanic in #316
• (sentry) Deprecate sentry.trace.parent_span_id by mjq in #287
• Don't run changelog generation on yarn generate by Lms24 in #277
• Avoid changelog generation recursion by Lms24 in #274

Documentation 📚

• (sentry) Add deprecated sentry.source by s1gr1d in #288
• Redirect from old /generated pages to new routes by Lms24 in #291
• Remove extra yarn run format instruction by mjq in #289
• Update README with up-to-date links by ericapisani in #258

Internal Changes 🔧

Deps

• Bump defu from 6.1.4 to 6.1.6 by dependabot in #309
• Bump vite from 6.4.1 to 6.4.2 by dependabot in #310
• Bump pygments from 2.19.2 to 2.20.0 in /python by dependabot in #307
• Bump smol-toml from 1.6.0 to 1.6.1 by dependabot in #305
• Bump h3 from 1.15.5 to 1.15.9 by dependabot in #299
• Bump devalue from 5.6.3 to 5.6.4 by dependabot in #286
• Bump dompurify from 3.3.1 to 3.3.2 by dependabot in #278
• Bump svgo from 3.3.2 to 3.3.3 by dependabot in #275
• Bump svelte from 5.51.5 to 5.53.5 by dependabot in #271
• Bump rollup from 4.40.1 to 4.59.0 by dependabot in #269
• Bump svelte from 5.48.1 to 5.51.5 by dependabot in #260

Deps Dev

• Bump tar from 7.5.10 to 7.5.11 by dependabot in #285
• Bump tar from 7.5.8 to 7.5.10 by dependabot in #276
• Bump tar from 7.5.7 to 7.5.8 by dependabot in #259

Other

• (ai) Deprecate rest of ai.* attributes by constantinius in #264
• (attributes) Ensure each attribute json has a changelog entry by Lms24 in #282
• (docs) Upgrade to Astro 6 by Lms24 in #283
• (gen_ai) Deprecate gen_ai.tool.input, gen_ai.tool.message, gen_ai.tool.output by constantinius in #265
• (publish) Bump next entries in changelog when releasing by Lms24 in #290
• (repo) Populate changelog property when running yarn create:attribute by Lms24 in #280

• Update CONTRIBUTING with process and minor changes by Lms24 in #255

• Update CONTRIBUTING with process and minor changes by Lms24 in #255
• Pin GitHub Actions to full-length commit SHAs by joshuarli in #302
• Wrong link to CONTRIBUTING.md in PR template by sentrivana in #298

Other

• deprecate(attributes): Mark gen_ai.tool.type as deprecated by ericapisani in #312

---

_{🤖 This preview updates automatically when you update the PR.}

[Lms24]

Gonna put this to draft for now since things are moving fast and we'll prioritize getting conventions up to speed before we make the process stricter.

[dingsdax]

should we add naming rules & examples?

Naming rules:

• Use dots as separators, not underscores (http.request.method, not http_request_method)
• Namespace first (db.system, not system.db)
• Keep names stable! Renames require deprecation cycles across all SDKs that adopted the attribute!

[Lms24]

Done. I weakened the "Keep names stable" one to "Prefer keeping names stable". We did take the opportunity for span first to change some span names for frankly quite terrible, namespace-less predecessors (I'm guilty of this a lot 😅). I think this shouldn't be discouraged too much but I agree that we shouldn't rename attributs "for fun" or more realistically because a name doesn't sound perfect.

[dingsdax]

Do we want something about the generates typed constants in CONTRIBUTING.md? What's our plan there, do we encourage that?

[Lms24]

Do we want something about the generates typed constants in CONTRIBUTING.md? What's our plan there, do we encourage that?

For us internally, I think that's a good idea. I think everyone should be able to cut a release at any time. I added a paragraph how to cut a release and what version to choose.

For users, I don't think this plays a role as we'd rather expose the attribute constants via our SDK packages (though internally, the SDK can depend on the generated packages).