Improve doxygen documentation for the VariantBuilder API

-Add full doxygen for all public API functions
-Improve/consolidate class-level comments

Resolves #322