doc/dev: update/re-org CI docs for buildchecker

Created by: bobheadxi

Also see https://github.com/sourcegraph/handbook/pull/1455

closes https://github.com/sourcegraph/sourcegraph/issues/25482