Asked what opinion he has formed recently about the future of documentation, the host says docs should be an asset, not a liability, and that wasting a reader's time is the main risk of AI-generated docs.
yeah,
so you talk to so many people across the space, like, and I'm sure you have opinions and they have opinions on the future of documentation. Like, what's the opinion you've formed recently?
…were looking for, or was it something along the lines of this, which is similar, almost like a recommender system of docs that you could have meant when you were looking for this, so that somebody could traverse easily and not have to read through the whole documentation? That is what I look at as a document being an asset because I am not wasting my time when I am looking through the docs. And the fact that it's so easy to churn out so much slop, we all are getting sick of reading slop. And I now have come to a point where I say to people, if it takes me longer to read your document than it took you to write it, I'm not going to read it.
I call that a brovella, like a novella. If it took longer to read than it took you to generate, like you're just you're forcing your lack of rigor on me.
Exactly.
And it does, like, if you go to any random, this is why I'm so angry and fired up about like docs today because you go to any renowned company's doc site, it is that slop fluff, and it feels like I'm getting the Yankee candle. You know, you walk into like a bed bath and be honest, like, ooh…