Open Telemetry Uncategorized, 10 Oct 2019

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: 2019-10-10 website SIG meeting

Description

OpenTelemetry website SIG meeting

A

B

C

You Eddie I'm.

B

Guessing it's just gonna, be the two of us.

A

Yeah Ted said that he was in the governor's meeting. It was running over.

B

A

I guess we can just go okay.

B

So, do we have any like I know.

A

At one point, I had granted summer.

B

Notice before the website should look like, but that was like a month or two ago. We.

A

Have like a like.

B

A dock or something of our current planners, we start.

A

Meeting those folks I do want to say that yeah there was a document somewhere remote with website should look like, but I can't find it.

A

A

My general idea was: we should pick a point in time, say like cube, Khan and try to figure out what we want to kind of get in there by then and then use that to sort of Center, our our appetite so to speak. I.

C

Think that's great I might add a more short-term milestone, which is just the point to release of this back whether there's any remaining work. We want to do for that.

A

You can do section here.

A

Uh-Oh, do you all have anything.

B

C

Project status, page I, think I can make a PR against that just to clean up the literal milestones listed there and I think poking the cigs. If you look at the actual statuses, they're kind of like all over the map, so it needs to maybe be around of like coordinating with the different SIG's who have posted a milestone. To actually have it be correct, like python is.

A

C

At point four, yet.

A

Yeah I have a community issue on that I.

B

A

A

Okay, what else I.

C

Think that was amazing or.

A

C

If we have start getting the guides together, it would be great. They get a page for each project going or something like that. More.

A

Short-Term I was thinking.

C

Of just making a pointer to the latest release form Eames project on that project, status, page Justin, to be a direct link right there. That would be a nice little enemy as well.

A

The bars on that graphic lickable and they take you to the repo, oh cool.

C

A

Maybe we need to call that out more yeah.

C

If they're short and I have the time, just like posting, the release notes for each latest release down below I might do that just to add more direct info onto the page. But if that, if they doesn't.

A

B

C

This things really have that together, I probably won't bother with it. Yeah.

A

I mean the trick with that. Is you can automate that and way that I'm automating the milestone the milestones yeah.

B

A

We wouldn't need all the things to make releases in the same way.

A

Yeah I mean we certainly seems like they just fit like the latest release.

C

Yeah, a simple script that just pulled the latest release from each sig and splatted github details. There would be probably a good incentive to assembly. The milestones were to get people to you know how something to github releases when they do a release, which might be a good practice. I, don't know if we have to maybe bring this up as a community issue first and like not just impose it on people or something, but in the short term, I can try to just do it by hand.

A

I mean I, don't know if everyone's using I would imagine everyone's using github relations.

C

I think people are mostly just posting directly to whatever package management system they have and like posting something up on. Github release is sort of like an extraneous step, but it is nice for people coming in to github. They can see that release tab, so it is. It is something that can help get people oriented, but I. Imagine like no one actually literally needs it to be an extra step.

A

Some of them some definitely don't some of them do just Python has a release. Java doesn't I.

C

A

It comes down to like.

B

A

Maintainer predilection yeah I mean that's quite a bit of it. Yeah it wouldn't be hard to I. Also, most of the work is already done of actually going and getting that information. So yeah.

C

A

It wouldn't be hard to add an additional thing that gave my status or not awesome, so I releases.

C

Well, tell you what, if you think you could with that part of it out quickly, I could change my test and just going into each backlog and making a request that people start using releases. I can point to.

A

Them like the reason yeah.

C

A

Will check that anything else? Morgan kind of short Charlie.

B

Yeah I think so product says page milestones: yeah.

C

A

Think I just for.

C

A

That's totally.

B

Sufficient 4.2 yeah.

C

As we start getting guides together, we can start throwing them up.

C

It's not like gating.

A

So theta /q con a QuickStart.

A

Okay, I think we need some like new user guides. You.

B

Know like a hello world example.

B

A

I mean I I see these as being more that kind of the stuff. That's right now found below the fold in the getting started like more like articles, it may be a little more holistic than just like saying: hey, here's, some here's, a quick start in the language or something it's like: hey, here's like a sample application and here's how you add, hotel and deploy it. You know really put collector or stuff like that.

C

Like just like a sample app so taking something like URIs hot rod, application and sorting it over that's more.

A

Yeah yeah, but also like, if you look at the site right now kind of underneath the latest from our blog thing. There's like these to get started sections.

C

A

Filling out those like those are just kind of dummy ideas ahead, but things like hey here's, how you migrate from open, tracing or open census for you.

C

Yeah there's also some like high-level Docs that exist on open census and open tracing websites. That.

A

C

Be straight cords right.

A

C

There's some stuff around like we can certainly have like at the high level. Here's like the layout of open tracing and then.

A

C

Can have a here's metrics from a high level and here's tracing from a high level yeah.

B

We know I'm almost.

A

C

Tracing stuff we could copy/paste I, don't know how similar the metric stuff is. Gonna be anymore, but oh.

A

We should probably uh yeah we apply just take the things that I wrote, the hotel, 101 Club and then yeah put that onto the site.

C

What I like about those goals is, it doesn't involve writing code or demo applications. That sounds like a thing. We can collectively actually pull off.

A

Also I think I have some open issues for a lot of this stuff. I.

A

A

Yeah configuration guides.

A

Migrations of tracing documentation do we want to there's the students lingering question of the? Where should the kannathil speck live.

B

We don't, is there an issue for just singing yeah I.

A

C

A

C

Has to stay on github I think the question has been whether or not we could make it formattable for the website and I think where we left that off was like. It would be easy to do that if we didn't make it formattable as marked down right, so it was sort of like one.

B

C

B

Fine, if it just staying on github, because they're like in context and it's an open.

B

C

B

C

Make the readme there the readme already has a pretty good table of contents, but if we make that a really welcoming place, yeah.

B

C

Could link directly to the readme so that it's full screen and I don't know it'll be fine, yep agree.

B

A

Yeah I just remember before the debate I'd like to get like a edit this or like a I could get a banner or something or some sung-yueng element that it takes you to the thing to let you make er's or open issues or whatever yeah.

C

Yeah I I think one thing: that's critical that we didn't do right and open tracing, but I think will do right. Here is as a user. You don't really need to read this spec like you should be able to read nice formatted articles on the website and get to know enough about open telemetry to go use it in.

A

C

We were kind of referring people there a little too much for though, like here's, the high-level overview of what this stuff is and so I think. That's why it was kind of annoying on open tracing. So if we just don't do that, if we just have enough other documentation that the spec is really just for the sig maintainer is to be looking at and coordinating with, and you know you can go, read it if you want to but like you don't have to, then it just won't matter that much.

A

Another thing when I add on here is the content cards that are below the hero right now. I want to flush that out a little bit because right now, just the blog posts, but I think we should have like other things, they're just stuff, that we want to drop people's attention to I.

A

A

Would be open to suggestions about the hero itself, I feel like it's I.

A

Don't know I, don't love them, but I don't have a better idea either attacking.

C

A

On the first thing, yeah, the public website Lee, the first thing you see is the logo and then a bunch of text. I.

B

Mean yeah, my big thing is like within, like five seconds. You should be able to have a maybe 15 seconds. People should have a basic idea of what we offer yeah.

A

Which is this does accomplish, so maybe we just say we're happy with it, because I.

C

Pretty low on my list, I might I.

A

C

Like the blog post might take up a little too much space, yeah I'm mobile yeah.

A

C

A

The idea for that is that there's going to be more stuff on that row.

C

A

That's also going to have that. That's where we can put like highlighted, feature articles or whatever or things you know things other than gingka blog post I kind of put that there, because I didn't have anything else put there. I need a place, but that so yeah.

C

Just one you may want to consider if medium will give you a smaller size or like a thumbnail chop of the image it might work better with the yeah just.

B

C

The rest of the webpage is doesn't isn't very, like image heavy the.

A

C

Giant image of you know leaves blowing in the wind takes.

A

A lot of screen real estate.

C

A

C

Be playing on my designer nerd glasses, yeah, it's I, don't actually care relative to all the content. We just talked about ready.

A

Yeah I'll choke I mean we can reduce the size of it. It's not a problem. Yeah.

B

You should add some basic community info.

A

Kay, there's a there is a under project involved. There is the start of that. Okay,.

B

A

We can touch it up. That was very helpfully Oktoberfest participant.

A

So we get in touch but yeah. We can flush that out more great.

A

So that feels like a lot for that feels like a good amount of stuff, like that probably feels like a little too much but I think if we can get other people to do the writing these days. Quickstart guides, then we'll be fine. Yeah.

C

I think you've got issues made for all of this already yeah.

A

The vast majority.

C

A

It I can I'll go through later tonight and I'll punch up the issues and make sure they represent this and do some awesome work yeah to be a good.

C

Use of the open, telemetry Twitter account by the way to tweet out hey, come help us write. Dogs I did a docket on for open tracing, let's back in the day, and that actually got you know for.

A

C

It contributes and docks so yeah yeah.

A

Ok, do I move on to GA.

A

So I'm a little I feel like I.

A

Don't really know what else other than just more.

B

A

C

A

C

A

A

Yeah I think at this point like: let's get there cute con and you go from there yeah.

A

I think there's some cool stuff that we can end up doing like in terms of turning this into sort of a neutral.

A

Like one thing, I would like to see as long as in the spirit of everyone being happy and on the same page is turning this into a good content hub for people that we publish stuff on.

C

A

You know there's so many people in the space and I was, you know, we're all working for different companies that have our own goals. Obviously, but if we can sort of form a good community around this, but it isn't just you know: vendors vendors enters like I, think making the hotel site be sort of the one-stop shop for people to come, find stuff and find these resources and be really good. So.

A

B

A

Know so cool I am actually good. Then, if you all are.

B

Ok, so awesome.

A

B

Just to start working through all of this, like I'm, happy to help of content and I can also help us with actual coresight programming. But like do you want to I know you have issues about big parts that you're looking to farm out, so people right now, I.

A

Think the biggest things right now would be these Quick Start Guide and some of this new user, because this guide content, okay, so the actual technical stuff isn't really that big of a deal and but what I? What I want to do? What I'll do is I'll, take a pig's eye to go and make sure that the issues and milestones are up to date, and then people can just you know. I can take responsibilities like managing issues and labeling things and making sure that if people want to work on stuff the it gets reviewed so.

B

So I'll just I guess over the next probably next week when I have more time. I'll just start picking up a few of these and writing. Little like I can take on what is, for example, okay, great yeah and what is tracing I think we did. What I think you intend said earlier, which is copy, that tracing site, yeah I've.

A

A

Did a what is tracing really like two days ago?

A

Let me linked it and.

C

A

C

Post a new post, yeah.

A

If you want to look at that and then see, I think it's that might just we could just take this and put it on here.

A

It'd be great to have these graphics cleaned up a little, but I also have a what is metrics post. That's getting yeah edited right now or actually no, it's been energy should be being published in.

A

C

A

We can take those and rework rewrite the words own. What we can write some thinkable, you knew I, don't really have a strong opinion. This.

C

A

But you know that things already written as though.

A

C

A

C

Post that could be repurposed as far as like explaining the topology of open, telemetry right, you break it down. You say: hey these api's you're using that for instrumentation, but then you've got to process the data and that's the clients. And then you got to send it somewhere and that's this collector and then you gotta put it in it back end and then.

A

C

You buy something from somebody yeah.

A

C

A

You see my new post 10, hmm send it to you, but it's it's basically that perfect.

C

A

Yeah these edits and then I'm the land of it. Having people check my work now great.

A

C

A

C

Forget one item, which is the.

A

C

A

Is another thing.

C

A

C

Kind of port over and I think there's someone else.

A

C

Interested in helping with that yeah.

A

I think this meter doesn't want to do that. I.

C

B

A lot more guys, it'll.

C

Be great when it happens, yeah.

B

Yeah I mean we could do it for beta, but I think if the registry is only done for GA, that's okay! Yes,.

A

Yeah, that's me. The G I, don't agree. Okay, cool beans.

A

Let's give everyone five minutes back. If anyone has stuff or wants to talk with us more, we do have the getter channel for hotel that I have yep.

C

Let's hope, let's hope it's still there.

B

Anyone was deleted by someone I'm gonna assume it was an accident yeah.

C

A

Anyone in the org delete things: Wow yep, yeah, okay! Well, thank you. Everyone! That's a good meeting! All right.

C

A