jiantw83
15825a5283
docs(ask): 補上目錄頁寫入語意並更新技能說明
What
- 問詢目錄頁範本新增「寫入語意」說明。
- 問詢目錄頁範本的規範指標改指向 jsc-meta 的 references/guidelines.md。
- README 的 ask 技能說明補上工作階段內只讀一次的行為。
Why
- 目錄頁一列代表一個存取庫,由所有存取庫共用。範本只給表格不給寫法,寫入者容易整頁覆寫,抹掉別的存取庫的列。
- 指標指向的規範檔案已經搬到 jsc-meta,舊指標讓讀者找不到來源。
- README 是外部讀者認識這個技能的第一份文件。技能已經改成一個工作階段只讀一次,說明沒跟上就會誤導讀者。
How
- 在目錄頁範本的說明區塊新增一段寫入語意:先讀回整頁,有列就更新該列,沒有才在文末附加,最後整頁寫回;明文禁止整頁覆蓋,也不得改動別人的列。
- 範本的指標改寫成 jsc-meta 的 references/guidelines.md。
- README 的技能段落補一句:兩頁在同一個工作階段只讀一次,之後沿用手上那份,自己寫入後就更新它,問出來的 wiki 存取庫也留在工作階段內重複使用。
Who
- 問詢目錄頁範本,以及存取庫首頁的 ask 技能說明。