Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Not to mention that there's no clear documentation for this anywhere. A while ago I was attempting to debug some Wayland-specific issues with a graphics library, it turns out the issue was that the little documentation there was, was wrong about what is and isn't nullable.


I found https://wayland.app/protocols/ very helpful so far.

That and studying smithay code.


That was the documentation with the incorrect nullability I was referencing.


I doubt there is anything incorrect there. See the note here: https://wayland.freedesktop.org/docs/book/Message_XML.html#a...


wayland.app just HTML-renders the contents of the specification XML files. If a compositor or client is not interpreting nullability the same way wayland.app says it should be interpreted, then that's a bug in the compositor or client.


What if no compositor is interpreting it correctly? We tested on Weston, GNOME (this was shortly after it went Wayland-only) and Plasma and the same problems persisted on all 3. In all fairness, the exact functions with wrong nullability might have been different, I don't remember, but the nullability issue itself was persistent on all 3.


What's needed beyond API docs is a review, refresh, and possible merging of the two Wayland Books by active Wayland contributors.

https://wayland.freedesktop.org/docs/book/ https://wayland-book.com/


This is what I dislike about a lot of open source projects (not all, but a significant amout of the notable ones) - publicly it's proclaimed that the code's open, and you are free to fix bugs and implement your changes.

But when you try to do so, you see there's very little documentation and help out in the open, and by the commit history, you can see there's been like three dozen people who have ever contributed to the project.

The rate of code change and the obscurity means the knowledge simply does not build up over time.

So it's unclear how to fix an issue you've encountered, or add a feature, and if you've done so, how to get your changes merged.


Not that I normally support this kind of thing, but.. how are the AI results in this context? Are they bad due to lack of docs?




Consider applying for YC's Summer 2026 batch! Applications are open till May 4

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: