I completely agree.
I think we need to set aside some time to revise and improve the documentation.
For example, Pokitto::Sound's documentation is practically nonexistant.
Any suggestions how to improve the documentation situation? Making good descriptions and short examples for the whole API requires a lot of work. Who are willing to do it? I myself can participate (to document a some of the methods or other area) if I am not the only one
No worries. Welcome to the outback, mate. You will soon find, that while our establishment isn’t very fancy, everybody is pretty friendly around here.
(I’m not completely sure if it’s the same problem but it sounds like what I remember from that thread.)
In fairness I (for one) have never forgotten that the documentation problem exists,
but admittedly I haven’t made as much of an effort as I should have done to fix it for various reasons.
Edit:
In fact I brought up #define PROJ_BUTTONS_POLLING_ONLY not being documented once before: