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