修訂控制與版本控制的真正分別

修訂控制與版本控制,是大部分從業者互換使用的近義詞。本頁指出兩者之間唯一真實存在的細微分別,不去發明一個實際上不存在的區別。

運作方式

  1. 為你自己的登記冊選定一個字眼,不再重新爭論

    為你機構的登記冊,決定用「修訂紀錄冊」還是「版本歷史」,把它放進登記冊自己的標題與欄位標頭,然後往前走。任由不同團隊為完全一樣的行,用不同詞彙各說各話,浪費的時間遠多於這個選擇本身的價值。

  2. 每一次修訂都有它自己的一行,絕不是一個被覆蓋的欄位

    在示例圖表裡,每一次修訂都是它自己一列「檔案」形狀的列,帶有自己的編號,在「編配項目編號並連結文件」配給,而不是一個你不斷覆寫的計數器。用同樣的方式建立你的紀錄冊:一次變更是一條新紀錄,不是對上一條的編輯。

  3. 在項目裡記錄改了甚麼,不只是有東西改了

    「記錄前後描述、作者與日期」,是值得原封不動照抄的一列:點名那個欄位或條款、它的舊值、它的新值、誰做的變更,以及何時。一行有日期、卻沒有寫明改了甚麼的紀錄,不是一條修訂項目,只是一個時間戳。

  4. 結案之前,對照文件核實項目

    「把紀錄項目對照已實施的變更查核」與它的「是否已對照文件核實?」關卡之所以存在,是因為項目與文件會漂移——一段在改動完成之前寫好的描述,或者一次比申請所講的走得更遠的改動。在結案這一行之前,把不一致送回出錯的那一方。

  5. 文件已經活在 QueryChart 裡時,讓紀錄自己記錄自己

    如果那份受控文件本身就是一張 QueryChart 圖表,它的變更日誌已經在每一次修改時,自動記錄誰改了哪個欄位、由甚麼改成甚麼,無須任何設定。你不用把上面那些修訂行,另外手動維護成一張獨立的表格——見 /features/version-control。

常見問題

「修訂」跟「版本」是同一回事嗎?

在大部分用法裡,是——兩個詞描述的是同一份底層紀錄,兩者互換使用,機制上沒有任何改變。真正出現分別的地方,是顆粒度:修訂通常指個別、有日期的變更,版本通常指那次變更套用之後,整份文件所處的結果狀態——在上面圖表裡,每一行是一次修訂,另一端走出來的那份文件,就是現行版本。

我應該把我的紀錄冊叫做「修訂紀錄冊」還是「版本歷史」?

跟從你機構、標準或軟件已經在用的那一個——ISO 9001 文件通常說「修訂」,大部分 SaaS 產品則說「版本」(包括 QueryChart,見 /features/version-control)——而你自己登記冊內部的一致性,遠比你挑哪個名詞重要。不要為同一項成品,同時並行使用兩個詞。

這個分別對審核重要嗎?

不是大家想像的那種重要。審核員查核的是每一次變更有沒有日期、有沒有歸屬、可不可以取回——不是登記冊用哪個名詞標記。更重要的是不要把「修訂控制」跟完整的文件管制生命周期混為一談:為一次變更編號,跟由頭到尾管制一份文件,兩者的分別見 /yue/guides/如何建立文件管制流程。

這個細微分別,實際上在哪裡最重要?

最直接的場合,是一本獨立的變更日誌或修訂登記冊——一項成品,它存在的全部目的,就是列出有日期的個別項目,而「修訂」描述這一點,比「版本」更精準。建立一本,見 /yue/guides/如何建立文件修訂紀錄;本頁假設的那個較廣泛定義,見 /yue/guides/文件sop與流程的版本控制是甚麼。

流程圖指南的更多內容