技術寫作
#
技術寫作
含有「技術寫作」共 11 篇內容
全部內容
發佈日期由新至舊
技術寫作基礎概念：Docs as a product 與 content first
本文整理了有關技術文件寫作的重要觀念，包括 docs as a product、內容優先，並說明如何構思文件架構。
2024-05-02
3
#
技術寫作
#
技術文件
#
寫作
Docs as Code 與知識管理系統
本文主要在討論以 Docs as Code 方法來撰寫技術文件，此做法能否滿足企業內部對知識管理的需求。
2024-05-01
5
#
技術寫作
#
TechnicalWriting
#
知識管理
Tom Johnson 的技術寫作經驗談
重點整理技術寫手 Tom Johnson 的兩段訪談。
2023-06-17
4
#
技術寫作
如何寫一份好讀的 API 技術文件？推薦學習技術寫作的好資源 — Documenting APIs
學習寫API文件很困難，尤其很難在網路上尋找好的教材。在這篇文章中我會分你分享 Tom Johnson 的 “Documenting APIs” 課程。他提供了一個簡單的學習路徑，幫助你了解基礎 API 知識和寫作技巧。如果你想精進自己的 API 文件寫作能力，這個課程不要錯過！
2023-03-16
10
#
文件
#
技術寫作
#
API
軟體公司如何在公司內部推行「寫文件」的公司文化 ? 6 點可以馬上開始實作的建議
對公司團隊來說，培養「寫文件」文化是非常棒的事情。例如降低新人 onboarding 時的教育成本、跨團隊溝通的時間成本。但多數的人都覺得「寫文件」是一件麻煩的事情。如果公司團隊要開始推行「寫文件」文化，應該如何做呢? 我有 6 點建議。
2022-10-26
8
#
文件
#
團隊
#
技術寫作
【入門篇】如何撰寫技術文章？軟體工程師推薦閱讀
在本篇文章中，會分享 3 個適合軟體工程師入門技術寫作的小技巧，以及一些在剛開始撰寫技術文章時可能會遇到的問題及對應心態調整的方式。
2022-10-11
15
#
寫作技巧
#
技術寫作
#
轉職軟體工程師
非產品部門的同事，對自家產品的功能不熟悉怎麼辦？透過舉辦 Workshop，提升公司內部成員對自家產品的熟悉程度
「為什麼非產品部門的同事，對產品操作會這麼不熟悉呢？」這是許多產品團隊都可能遭遇的問題。這篇文章分享我在公司舉辦 Workshop (工作坊)的經驗。包含 3 部分：(1) 為什麼要舉辦 Workshop？ (2) 如何準備 Workshop？(3) 我從 Workshop 學到的 3 點經驗教訓
2022-09-16
2
#
工作坊
#
產品
#
技術寫作
4 種技術文件幫助 SaaS 公司提供更好的產品/服務體驗 (提升使用者與合作夥伴對產品的掌握度，更喜歡公司提供的產)
SaaS 公司提供即時、線上的軟體產品/服務，因此讓小白使用者「好上手」是非常重要的。但使用者卡關時怎麼辦？一個不用浪費公司太多人力、又能讓使用者快速排除問題的方法就是：「提供技術文件」。如果你的公司內部/產品團隊沒有專門的Technical Writer，看完這篇文章可以讓你了解 4 種產品必要的
2022-07-29
1
#
技術寫作
#
SaaS
軟體產業中的 Technical Writer 在做些什麼，為什麼「寫文件」這件事情不都交給 PM 做就好？
我曾經擔任 PM 將近 6 年的時間、在新職位 - Technical Writer 工作 9 個月的時間，這篇文章分享關於「寫文件」這件事 - 包含 Technical Writer 在做些什麼、跟「產品經理(Product Manager)」的差異。如果你對軟體產業有興趣，一起來看看這篇文章吧。
2022-07-22
10
#
SaaS
#
技術寫作
#
寫作
「技術寫作」的市場性
「技術寫作」也是文字工作者的一條出路，只是比較少為人知。
2020-02-22
2
#
hardcopy
#
寫作
#
技術寫作
