Comments (8)
I agree with @tedsuo, that's a great website @joaopgrassi 🙌 ✨ Y'all are touching on important points. Maybe we can discuss this during Monday's comms meeting? I've added an item to the OTel comms meeting notes.
Immediate thoughts that come to mind:
- Initially linking out to @joaopgrassi's website from OTel.io sounds like a quick and easy solution -- possibly with a disclaimer that the website is not an officially endorsed by OTel maintainers(?).
- Later, if there is a agreement by all parties that the recipes could/should live in this repo (or maybe a "docs-contrib" repo, or under a "recipes" folder of each SIG's repo) and displayed on OTel.io, then what would it take to make this happen? Maybe at some point down the road, you (@joaopgrassi) won't want to manage the maintenance or review of the recipes, and it would make sense to shift this over to be under the OTel org. Just a thought. We can face this if/when it happens.
from opentelemetry.io.
Hum I'm not sure what integrate here would be. I have many ideas for it and have put in a lot of effort in designing and all of that so not sure 😅
Your project solves a problem that the official website/docs has and that many people complain about: they look for an easy copy&paste solution for them to get started with OpenTelemetry and what ever project they are working on, and we do not provide that in an easy to consume way (I could give some arguments that we have some of that, but it is indeed burried in the wordy docs). @tedsuo made a similar comment the other day, so I am tagging Ted for visibility:)
We need the wordy docs but eventually we want to have something like that for opentelemetry.io as well. We had discussions around that in the past, we also had ideas to add "examples" to the registry. However, adding that would not only duplicate work, but also take away from your project as a first starter.
So my preferred solution would providing an integration/linking from the website to the recipes, e.g. if someone reads the .NET docs they should find their way to https://otelrecipes.com/recipes?recipe=csharp.aspnetapi.traces and https://otelrecipes.com/recipes?recipe=csharp.console.traces and all other csharp.*
For that otelrecipes does not have to become "fully integrated" into opentelemetry.io (aka living here in this repo etc.), apologies if I indicated that. However, we need to get a lot of logistics addressed, foremost the question how much we want to build a dependency on an "outside" project
from opentelemetry.io.
Two things come to mind for me:
-
Like the famed website dotnet pearls there's room for an alternative website of short & sweet snippets of code you can easily copy and paste. The official docs don't need to be the only place to learn specifics stuff with OTel. But they should be the canonical source for information and thus may be longer and more elaborate.
-
There could be a section of the official docs that could be a semi-organized collection of recipes. We would make no attempt to try and elaborate on the recipes; they're intended to be small in nature. Got a nifty use case? Plop it in the recipe book!
I'm not sure which I prefer. But I do believe that for (1), we should definitely link to it from the website here. I think a link in the TOC under the Ecosystem tab would make the most sense for that.
from opentelemetry.io.
Great website, @joaopgrassi!
I feel that this should stay the way it is, and we should link to it in various places where it would be helpful.
For our core documentation, we have the demo apps, I think that's enough as far as examples go. Where I would like to improve our documentation is pulling out the bits that should be copypasta'd so that there is a shorter quickstart guide that is less demo focused. But we can always learn how to improve our demo-based documentation as well.
from opentelemetry.io.
@chalin sounds like a great plan to me! It was/is always my idea/intention that, at some point, it becomes a community driven project and it's out of my hands :). I will support it as long as I can/have personal time.
from opentelemetry.io.
Before we talk about listing, can we explore if and how we integrate it into the OpenTelemetry website directly (if you and the other authors would be open to do that?). This is really cool and I can imagine that this would be a great addition to the website somehow.
from opentelemetry.io.
Hum I'm not sure what integrate here would be. I have many ideas for it and have put in a lot of effort in designing and all of that so not sure 😅
from opentelemetry.io.
+CC @avillela because of the tutorials' idea.
from opentelemetry.io.
Related Issues (20)
- Announcements page: either hide or improve the page listing HOT 4
- [i18n] Support Netlify redirects for non `en` pages
- [CI & i18n] Support page formatting for `ja` and `zh` pages
- [zh] Page updates needed + missing link HOT 3
- Failed to execute npm run seq HOT 14
- [CI] i18n GH action check doesn't always work
- fix supported python version for Python SDK in main page HOT 6
- Contributing guidelines should be consolidated in one place
- Spec status "Experimental" renamed to "Development": Adjust shortcodes and language statuses
- Document new version of Health Check extension
- New Blog Post: Humans of OTel - KubeCon EU HOT 2
- New Blog Post: Getting Started Survey HOT 2
- [i18n] Ensure that fallback pages have `en` lang attribute
- Page internal search shows external results HOT 4
- [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
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.