(doxygen etc) generated docs for your API is only better than nothing. If you want *good* documentation, you need to put in a little more work.