Thanks for the reply @marekd. I completely understand your priorities (what developer really wants to write documentation ;) ) and I am slowly slugging through things and figuring things out.
I am pretty sure some solid docs would end up with more people using and building on Windy.com and that can only be a good thing for you guys. I am happy to help if you want...
Hi @powellbound, consider Windy API as an another normal Leaflet layer. Everything else is provided by Leaflet itself (eg. markers, its lat lon, distance, ...).