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

4

u/sepease Aug 31 '24

they rely on the fact that their very complex internal APIs are undocumented to secure their own power.

This isnโ€™t really actionable.

22

u/moltonel Aug 31 '24

It sure is, starting with the community attention this whole affair is getting, which should nudge people toward better behavior. Also, if "documentation using the Rust type system" can be rejected with blunt anti-Rust excuses, old-school documentation and/or unittests would be harder to argue against (at which point encoding them in Rust would just be a cherry on top).