Commit 61885f0
committed
docs(spec): add source citations and unverified-URL list for external facts in 03
Audit P1-005 fix. 03 v0.1 referenced many upstream facts (mips removal,
clang/llvm 19, pkgbase, pr_usrreqs merge, inpcb SMR, if_t opaqueness,
netlink, RACK default, KTLS, routing/rib/nexthop, 14.4/15.1 timeline)
but contained zero URLs and zero retrieval dates. This commit adds a
new section 10 to 03 with two layers:
- 10.1 Locally-verifiable sources (path:line + quotation), sourced
primarily from the in-tree freebsd-src-releng-15.0 / 13.0 trees
(RELNOTES, UPDATING, sys/conf/newvers.sh, sys/sys/param.h,
sys/conf/files, sys/sys/protosw.h, sys/netinet/in_pcb.h,
sys/net/if.h, sys/net/if_var.h, sys/netlink/).
- 10.2 Unverified external URL queue, listing 8 facts that still
need network access (clang 19 import date, pkgbase status,
netlink intro year, RACK default knob, KTLS commit, routing
rewrite design doc, 14.x release timeline, 15.1 placeholder),
each with candidate URL(s) and a turning-into-verified condition.
- 10.3 Verification protocol: when to verify (before M1 kickoff),
how to record (URL + retrieval date + quote), fallback when URL
unreachable, and the future Phase 4 reviewer check.
Files:
- 03-freebsd-15-changes.md: append section 10 (47 new lines).
- 98-independent-audit-report.md: P1-005 and sec 6.1 item 6 marked
'fixed 2026-05-28, see 99 sec 12.6'.
- 99-review-report.md: append sec 12.6 revision record.
Why not a separate 03-appendix-sources.md (one of the audit's two
suggested approaches): keeping the citations inline in 03 sec 10
avoids cross-file maintenance cost while still meeting the
'every external fact has a verifiable source or an explicit
unverified label' requirement.
Verification:
grep -cE 'sys/conf/newvers\.sh|sys/sys/param\.h|UPDATING:|RELNOTES:\
|sys/sys/protosw\.h|sys/netinet/in_pcb\.h|sys/net/if\.h\
|sys/net/if_var\.h|sys/conf/files|sys/netlink' \
zh_cn/03-freebsd-15-changes.md
# -> 13 hits, all in section 10.1.
The 8 unverified URL items are non-blocking for the Spec stage
(Go/No-Go decision 'as Spec draft = GO' stays unchanged); the human
reviewer should resolve them during M1 preparation.
Lint: 0 diagnostics across zh_cn/.1 parent d198466 commit 61885f0
3 files changed
Lines changed: 64 additions & 2 deletions
File tree
- docs/freebsd_13_to_15_upgrade_spec/zh_cn
Lines changed: 47 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
319 | 319 | | |
320 | 320 | | |
321 | 321 | | |
| 322 | + | |
| 323 | + | |
| 324 | + | |
| 325 | + | |
| 326 | + | |
| 327 | + | |
| 328 | + | |
| 329 | + | |
| 330 | + | |
| 331 | + | |
| 332 | + | |
| 333 | + | |
| 334 | + | |
| 335 | + | |
| 336 | + | |
| 337 | + | |
| 338 | + | |
| 339 | + | |
| 340 | + | |
| 341 | + | |
| 342 | + | |
| 343 | + | |
| 344 | + | |
| 345 | + | |
| 346 | + | |
| 347 | + | |
| 348 | + | |
| 349 | + | |
| 350 | + | |
| 351 | + | |
| 352 | + | |
| 353 | + | |
| 354 | + | |
| 355 | + | |
| 356 | + | |
| 357 | + | |
| 358 | + | |
| 359 | + | |
| 360 | + | |
| 361 | + | |
| 362 | + | |
| 363 | + | |
| 364 | + | |
| 365 | + | |
| 366 | + | |
| 367 | + | |
| 368 | + | |
Lines changed: 2 additions & 2 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
114 | 114 | | |
115 | 115 | | |
116 | 116 | | |
117 | | - | |
| 117 | + | |
118 | 118 | | |
119 | 119 | | |
120 | 120 | | |
| |||
206 | 206 | | |
207 | 207 | | |
208 | 208 | | |
209 | | - | |
| 209 | + | |
210 | 210 | | |
211 | 211 | | |
212 | 212 | | |
| |||
Lines changed: 15 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
444 | 444 | | |
445 | 445 | | |
446 | 446 | | |
| 447 | + | |
| 448 | + | |
| 449 | + | |
| 450 | + | |
| 451 | + | |
| 452 | + | |
| 453 | + | |
| 454 | + | |
| 455 | + | |
| 456 | + | |
| 457 | + | |
| 458 | + | |
| 459 | + | |
| 460 | + | |
| 461 | + | |
0 commit comments