better documentation of wd_ calls and returns