refine doc

Author: tadelesh

packages/typespec-go/.scripts/sync-baseline.js

@@ -7,25 +7,9 @@
 // After tspcompile.js finishes regeneration it mirrors the locally
 // generated test artifacts into this checkout, so developers can
 // `git diff` / `git status` inside temp/baseline to inspect codegen
-// changes against the merged baseline. No separate `pnpm show-diff`
-// command is required.
+// changes against the merged baseline.
 //
 // Skip with TYPESPEC_GO_SKIP_BASELINE=1 (used by CI / offline runs).
-//
-// Conflict semantics (verified):
-//  - Re-running sync while a previous mirror is still present (as untracked
-//    files) does NOT raise a git conflict. `git reset --hard FETCH_HEAD` is a
-//    no-op for purely-untracked paths and silently overwrites them when the
-//    baseline tip starts tracking the same path. In both cases the mirror
-//    runs again immediately afterwards (see tspcompile.js beforeExit hook),
-//    so the working tree is rewritten to match the latest local emit. Net
-//    effect on every successful run: working tree == baseline tip + local
-//    emit overlay.
-//  - Fetch / network failures are caught and downgraded to a WARN; the rest
-//    of regeneration continues without baseline mirroring.
-//  - Concurrent runs against the same checkout: the second invocation's
-//    `git fetch` may fail with "shallow file has changed"; this is also
-//    caught and downgraded to a WARN.
 
 import { execFileSync } from "child_process";
 import { cpSync, existsSync, mkdirSync, readdirSync, rmSync, statSync, writeFileSync } from "fs";