You're totally right.I did my best to document the .gd files, but I'm still working on proper documentation and examples.
I wasn't expecting this bigger surge of interest, but since I got them now (thanks Gwizz!) I'll put some priority on it.