[1.6.x] Fixed #21625 -- incorrect documentation for DiscoverRunner.build_suite

Backport of b62031441b2e1cb1eeb7e1d6f254c553643add96 from master.