Adding contributors to your Hugo website
Saturday, May 11, 2024 in Blog
This post describes how to add contributors to each page by modifying Docsy's default content …
Center images with URI fragment
Tuesday, May 07, 2024 in Blog
Update 2024-05-08: After I post a question on the Hugo discourse site, Joe Mooring replied and …
技術寫作入門:docs as a product 與 content first
Wednesday, May 01, 2024 in Blog
目標讀者:軟體開發人員、DevOps 工程師、產品經理 概要 上一篇筆記提到 Docs as Code,指的是以跟寫程式一樣或相似的工具與流程來製作文件。這篇筆記要再介紹兩個有關技術文件寫作的基礎觀 …
Docs as Code 與知識管理系統
Wednesday, April 24, 2024 in Blog
你任職的公司裡面有沒有使用現成的知識分享平台或知識管理系統?例如 Confluence、Document360 等等。 更新:後來從我的臉書貼文下方收到一些網友的分享, …
Code review
Saturday, April 13, 2024 in Blog
In this post: 為何做 code review? 走味的 code review。 為何做 code review? 實施 code review 的兩個主要理由:提高程式品質,以及傳遞知 …
Redoc side menu woes with Bootstrap CSS 5.x
Saturday, April 06, 2024 in Blog
Symptom In a static website built with Hugo and Docsy theme, I added a page to render an OpenAPI …
A Hugo Shortcode for rendering a CSV file as an HTML table
Monday, March 25, 2024 in Blog
In this post, I share my Hugo shortcode that can render a .CSV file as an HTML table. Code by …
GitHub Copilot 入門
Sunday, February 18, 2024 in Blog
超級 lag 的我,終於也開始用 Copilot 啦。 簡介 Copilot 能做什麼? 當我們寫程式的時候,Copilot 會在背後忙著推測我們的意圖,並適時提供它建議的程式碼。 除了幫我們產生程式 …
《高品質軟體文件》筆記:維持文件的正確性
Monday, October 16, 2023 in Blog
中文書名:《高品質軟體文件》 原文書名:Living Documentation 作者:Cyrille Martraire 譯者:楊尊一 我也有買英文版,所以有時會中英交替著看。這裡我想從書中摘出我 …
Using ShareThis Reaction Buttons
Sunday, October 15, 2023 in Blog
Change Summary Two changes has been made today. The first is change is a fix for C# tag 404 error, …