We have considered parsing both headers and documentation in order to make the generated API prettier. This is the first release, so we want to see if there is interest, but yes there are lots of things we could do to expand the project (Auto documentation in header files, other language bindings...)