Comments (4)
Thanks for creating this issue to track the discussion. My main objective in the original edit was to ensure that "Collector" was capitalized. Otherwise, we (should) use sentence case in headings (per our language guide(ance) -- though we haven't started applying that consistently at all.
I like what @svrnm proposes.
All-in-all, this isn't a super important; and sorry for having brought it up. As I mentioned, it was really the capitalization of Collector I was primarily targeting.
from opentelemetry.io.
the way it is solved now and especially moving the "experimental" out of the title is a good solution! I think we can close this one
from opentelemetry.io.
@chalin, @svrnm: Please feel free to edit my description.
from opentelemetry.io.
Ah, ok, now I understand. Thinking out loud, how about the following:
- We use
Experimental
(with a link to the explanation in the spec) whenever it's spec/semconv-Experimental - We use
experimental
otherwise
This way we can make it clear to readers that the one thing is "official". Of course that linking may not work in a title.
from opentelemetry.io.
Related Issues (20)
- [i18n][design] Interpret absolute paths as locale specific
- Create blog post for KubeCon China
- Update blog policy for posts including other CNCF projects
- New Blog Post: Tips for Troubleshooting the Target Allocator HOT 2
- Documentation update: add troubleshooting tips for OpenTelemetry Operator's Target Allocator HOT 1
- Misleading link to collector from SDK examples HOT 4
- Documentation update: add troubleshooting tips for OpenTelemetry Operator's Auto-instrumentation capability
- Create documentation for running the OTel Demo on GitHub Codespaces HOT 5
- chinese character "軽装" should be "計装" HOT 2
- Documentation issue in: Building a custom collector HOT 7
- Collector docs high-level pipeline architecture image needs to be updated HOT 1
- Documentation issue: Building a receiver (tutorial) HOT 2
- [i18n] Tooling to detect inconsistent translation and formatting Japanese text HOT 3
- [ja] CNCF localization guidelines - feedback requested HOT 4
- FYI - `google-cloud-cpp` is a C++ library with a native OpenTelemetry instrumentation HOT 1
- gRPC is a library with native OpenTelemetry instrumentation HOT 4
- Common doc between the Java agent and the OTel starter HOT 1
- New Blog Post: Hardening the Collector #1 - A new default bind address HOT 3
- [i18n] Ensure section-local image paths fall back to default lang image HOT 1
- Add words to contribution guideline for images and translations
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from opentelemetry.io.