doc: clarified the return values of the "build" method