如何建立更新日誌頁面:條目、標籤、RSS 及「最新功能」
更新日誌頁面是按日期排列的產品改動清單,最新的排在最前,並以使用者為對象撰寫。要建立一個,你需要附有日期、清晰標題、簡短說明和標籤(新增、改善、修正)的條目,一個列出這些條目的頁面,每則條目各自的網址,最好還要有 RSS 訂閱源,以及一個可以告知用戶有新內容的方式。這是你可以建立的最簡單的功能之一,最主要的決定是條目存放在哪裡:存為網站內的檔案,還是存入附有管理頁面的資料庫。
為什麼值得擁有更新日誌
更新日誌向客戶和潛在客戶展示產品仍在維護。當有人問「它現在能做到 X 嗎?」時,支援和銷售團隊可以把更新日誌的連結發給對方。它也是完成回饋循環的地方:當用戶要求的功能推出後,你可以把他們指向更新日誌中的相應條目。如果你運作的是客戶回饋入口網站,請把已推出的要求直接連結到其條目。
更新日誌不是你的內部提交紀錄。「重構計費服務」對用戶來說毫無意義;「發票現在會顯示你公司的增值稅號碼」則有意義。
頁面需要什麼
每則條目的內容
| 欄位 | 備註 |
|---|---|
| 標題 | 從用戶角度說明改動了什麼 |
| 日期 | 發布日期,顯示在頁面上 |
| 標籤 | 新增、改善、修正(也可以有移除或安全性) |
| 內文 | 幾句句子或重點項目;說明如何使用,以及哪些人可以使用 |
| 圖片或影片 | 可選;一張截圖通常比一段文字更有幫助 |
| Slug | 條目的網址,例如 /changelog/invoice-vat-numbers |
| 狀態 | 草稿或已發布;如有需要,可加上預定發布日期 |
頁面
- 更新日誌索引:最新的排在最前,附有標籤篩選,以及簡單的分頁或「載入更多」。
- 條目頁面:每個網址只對應一則條目,方便連結和分享。
- RSS 或 Atom 訂閱源:讓人和工具無需電郵也能追蹤更新。
- 管理頁面(僅限資料庫版本):撰寫、預覽、排程及發布條目。
應用程式內的附加功能
- 「最新功能」提示:當有用戶未看過的條目時,在選單項目上顯示一個小圓點。按用戶或瀏覽器儲存他們最後開啟的條目日期。
- 電郵摘要:發送給已同意接收的用戶。這需要發送電郵的服務供應商;請參閱如何從應用程式發送電郵。
主要決定:檔案還是資料庫
條目作為網站內的檔案
每則條目都是專案中的一個 Markdown 檔案。要發布條目,就是加入一個檔案然後重新部署。這是最簡單、最穩健的做法:不需要資料庫、不需要管理員登入、沒有需要保護的東西,而且頁面可以預先渲染,載入快,也方便搜尋引擎讀取。
這種方式適合撰寫條目的人願意請 AI 生成器協助或直接編輯檔案的團隊。
條目存放在附有管理頁面的資料庫
條目存放在資料表中,私人管理頁面讓團隊中的任何人都可以撰寫、預覽、排程和發布。這適合由市場推廣或客服團隊撰寫更新的團隊,或是你需要定時發布,或按受眾發布條目的情況(例如只向企業客戶顯示企業功能)。
代價是需要建置和維護更多東西:管理員登入、圖片上載,並確保公開頁面仍可供搜尋引擎讀取。如果頁面只在瀏覽器中載入條目,搜尋引擎可能就無法讀取。
| 檔案 | 資料庫 + 管理頁面 | |
|---|---|---|
| 誰可以發布 | 任何可以編輯專案的人 | 任何擁有管理員登入的人 |
| 設定 | 極少 | 登入、儲存空間、管理介面 |
| SEO | 容易(頁面預先渲染) | 需要小心處理,確保頁面在伺服器端渲染或預先渲染 |
| 排程 | 部署時發布 | 可以按日期排程 |
| 託管成本 | 靜態 | 需要持續運行的應用程式及資料庫 |
撰寫讀者會看的條目
- 先講好處。「將報告匯出為 Excel」比「全新匯出模組」更吸引。
- 說明哪些人可以使用。 所有方案、僅限 Pro、本週逐步推出。
- 展示成果。 一張截圖或一段短片。
- 把小修正集中起來。 每週一則附有重點項目的「修正與改善」條目,可以避免頁面被大量細碎更新淹沒。
- 對移除功能要坦白。 如果某項功能將會停用,請說明時間,以及應改用什麼。
行之有效的首個提示
在我們網站的 /changelog 加入一個公開的更新日誌。每則條目是一個 Markdown 檔案,包括標題、日期、標籤(新增、改善或修正)、可選的封面圖片和內文。索引頁面以最新的排在最前,顯示日期、標籤和第一段文字,並有標籤篩選按鈕,每頁顯示 10 則條目。每則條目在 /changelog/<slug> 有自己的頁面,並為搜尋引擎提供適當的頁面標題和描述。在 /changelog/rss.xml 加入 RSS 訂閱源。建立三則範例條目。配合現有網站的設計,確保在手機上易於閱讀,並預先渲染頁面以加快載入速度。
如果是資料庫版本,請把第一句改為:「將條目儲存在資料庫中,附有草稿或已發布的狀態及發布日期,並加入一個受密碼保護的管理頁面,用來撰寫、預覽和發布條目。」
建置步驟
- 根據上面的表格,決定使用檔案還是資料庫。
- 建置索引頁和條目頁,並加入幾則範例條目。
- 加入標籤和篩選。
- 加入 RSS 訂閱源,並在頁面上連結。
- 為每則條目加入頁面標題、描述及網站地圖項目。 AI 製作網站的 SEO 指南涵蓋了基本做法。
- 如果你選擇資料庫路線,建立管理頁面和登入功能。
- 在你的應用程式中加入「最新功能」提示。
- 為過去幾個月撰寫真實條目,讓頁面上線時不會是空的。
常見錯誤
- 直接複製提交訊息。 應為用戶撰寫,而不是為開發人員撰寫。
- 所有內容集中在一個大頁面,沒有各自的條目網址。 沒有人可以連結到特定改動,而且搜尋引擎只會看到一個頁面,而不是許多頁面。
- 更新在一個月後停止。 一年前才更新過的更新日誌會令人以為產品已被放棄。請訂立你能夠持續維持的節奏。
- 只在瀏覽器中載入條目。 搜尋引擎和連結預覽可能只看到空白頁面。應預先渲染,或在伺服器端渲染。
- 混入事故通告。 服務中斷應該放在狀態頁面,而不是更新日誌中。
何時現成的更新日誌工具更好
市面上有代管的更新日誌和產品更新工具,部分還附有回饋看板或應用程式內小工具。如果你希望不用自行建置就能擁有應用程式內彈出視窗、受眾定位和分析功能,或你的團隊已經為包含此功能的工具付費,這類工具就值得考慮。你的網誌或說明中心軟件也可能已有合適的格式。
如果你希望更新日誌位於自己的網域、採用自己的設計,並且可以完全被搜尋引擎索引,那麼自行建立就很有意義。對於一份簡單的按日期排列的文章列表來說,所需的工作並不多。
使用 Mythex 建立
在 Mythex 中,你可以要求代理在現有專案中加入更新日誌,或把它建成獨立的小型網站,並在建置過程中於即時預覽中看到成果。以檔案為基礎的版本不需要資料庫。如果你選擇管理版本,當條目需要儲存時,代理會加入專屬的 Postgres 資料庫(或輸入 /database),而截圖則存放在專案檔案儲存空間中。管理員登入需要你以自己的驗證方式另行加入(加入登入功能的指引)。
新的 Mythex 應用程式通常是用戶端渲染的單頁應用程式,而 SEO 指引指出這類應用程式對搜尋的效果較弱,因此如果你希望條目能在搜尋中被找到,請要求提供靜態或預先渲染的更新日誌頁面。同一份指引也涵蓋標題、描述和網站地圖。如果想要一個內建更新日誌的起點,可以參考產品知識中心範本。
常見問題
更新日誌的每則條目應該包括什麼?
日期、一個簡短的標題(說明對用戶來說改動了什麼)、幾句句子或重點項目來解釋改動、一個標籤(例如新增、改善或修正),還可以加入截圖和連往更多詳情的連結。
更新日誌一定需要資料庫嗎?
不一定。如果只有一兩個人發布更新,條目可以作為 Markdown 檔案存放在網站內,並隨每次部署發布。當非技術人員需要透過管理頁面撰寫和排程條目時,才需要使用資料庫。
我應該多久更新一次更新日誌?
只要用戶會留意到的任何改動,就應該更新。很多小型產品會每週或每兩週把改動集中發布;重要的是保持穩定節奏,讓頁面看起來是活躍的。
更新日誌對 SEO 有幫助嗎?
會有少許幫助:每則條目都是一個可供搜尋引擎抓取、介紹某項功能的頁面,而定期更新的頁面也顯示產品仍在積極開發。請讓每則條目擁有自己的網址,並使用描述性的標題。