Matthew Sanabria

Sometimes you can only express what you want to do in natural language. And you don't really know what the code is going to look like. And you want to have that translation. But are we there yet reliably? Definitely not.

Sometimes you can only express what you want to do in natural language. And you don't really know what the code is going to look like. And you want to have that translation. But are we there yet reliably? Definitely not.

I'm sure. You know, send me a link. I got you.

I'm sure. You know, send me a link. I got you.

Does this, um, require you to go down the levels here or the actions? Like, for example, do you have to do a praise and understand before you can do explore? Is that what the author is getting at? Or can you kind of just do any of the seven actions?

Does this, um, require you to go down the levels here or the actions? Like, for example, do you have to do a praise and understand before you can do explore? Is that what the author is getting at? Or can you kind of just do any of the seven actions?

Yeah. I, I, My opinion on this whole documentation thing is I agree that we have too few documentation or what is that? We have not enough documentation out there in relation to the code and to the things that we have available. And if I have to go look at the source code to understand what things are doing, That's a failure in my opinion. And like OpenTelemetry does this pretty well.

Yeah. I, I, My opinion on this whole documentation thing is I agree that we have too few documentation or what is that? We have not enough documentation out there in relation to the code and to the things that we have available. And if I have to go look at the source code to understand what things are doing, That's a failure in my opinion. And like OpenTelemetry does this pretty well.

Like fails pretty well, I guess is what I'm trying to say. I'm not trying to be mean or anything. Yeah, I'm not trying to be mean or anything with that. I'm really not.

Like fails pretty well, I guess is what I'm trying to say. I'm not trying to be mean or anything. Yeah, I'm not trying to be mean or anything with that. I'm really not.

It's just when I was working with OpenTelemetry, I found myself always having to go to the source code because there was either no docs or the docs were far out of date and not kept up and they were kind of meaningless at that point. And it's like if you're telling your users to do that, then you're going to suffer. Like nobody's going to know what your program does. Adoption is going to suffer.

It's just when I was working with OpenTelemetry, I found myself always having to go to the source code because there was either no docs or the docs were far out of date and not kept up and they were kind of meaningless at that point. And it's like if you're telling your users to do that, then you're going to suffer. Like nobody's going to know what your program does. Adoption is going to suffer.

People are going to be upset using your thing. And it just breeds like an animosity using your tooling. Like is that what you really want? And you hit it right on the head, Jared. Like a small paragraph describing how things are laid out or kind of like the concepts and ideas can go a long way to unlocking your mental model to understanding what it is you're doing and looking at.

People are going to be upset using your thing. And it just breeds like an animosity using your tooling. Like is that what you really want? And you hit it right on the head, Jared. Like a small paragraph describing how things are laid out or kind of like the concepts and ideas can go a long way to unlocking your mental model to understanding what it is you're doing and looking at.

Yeah, write the paragraph.

Yeah, write the paragraph.

Request for discussion. Request for discussion, yeah. Okay. We have, I think, over 500, 600 RFDs now, somewhere in between 500 to 600. And you're right. Like, we have search, and it's, like, full-text search. You get to search the title of the RFD and the content as well. But you're correct. There's no, like... organization structure to them.

Request for discussion. Request for discussion, yeah. Okay. We have, I think, over 500, 600 RFDs now, somewhere in between 500 to 600. And you're right. Like, we have search, and it's, like, full-text search. You get to search the title of the RFD and the content as well. But you're correct. There's no, like... organization structure to them.

Unless the author of an RFD put in enough keywords that will be generally searchable and accurate, it's kind of difficult to find them. And as a new employee to Oxide, that makes it difficult for me because if I search generic keywords, I get maybe hundreds of results back. And now what's actually relevant to me? What do I actually want to read and go into?

Unless the author of an RFD put in enough keywords that will be generally searchable and accurate, it's kind of difficult to find them. And as a new employee to Oxide, that makes it difficult for me because if I search generic keywords, I get maybe hundreds of results back. And now what's actually relevant to me? What do I actually want to read and go into?