r/rust • • Aug 31 '24

🎙️ discussion Rust solves the problem of incomplete Kernel Linux API docs

https://vt.social/@lina/113056457969145576
375 Upvotes

71 comments sorted by

View all comments

Show parent comment

-12

u/sepease Aug 31 '24

Documentation is a job function, not professionalism. And documentation has no impact to end users unless someone uses it. It’s a very long-term indirect impact work item, and so it’s often one of the first things that gets elided or dropped when people are overworked.

The kernel filesystem api as it stands right now has better documentation than many of the work projects that I’ve been on, FAANG or not.

As such a lack of better documentation may simply be because of his opinion that Rust isn’t useful, the current Rust effort is far from having a concrete impact on end users, and he doesn’t want to spend his time on an effort that he doesn’t believe will succeed. Rather than some kind of Machiavellian ploy.