GripNewsMay 12
🌖 嵌入技術的潛力被嚴重低估
➤ 文字語義的數學革命 - 從Word2vec到現代嵌入模型的技術躍遷
✤ https://technicalwriting.dev/ml/embeddings/overview.html
本文探討機器學習中的嵌入技術如何革新技術寫作領域，解析其運作原理與實際應用方式，並比較主流嵌入模型的效能差異。
+ 原來Google文件的分類建議背後是這種技術！終於理解為什麼搜尋引擎能找出相關文件了
+ 雖然效率高，但訓練這些模型消耗的能源問題還是令人擔憂，作者應該更深入探討環境成本
##人工智慧 #自然語言處理 #技術寫作
Embeddings are underrated

GripNewsNov 1, 2024
🌘 嵌入式一直被低估
➤ 嵌入式技術的應用及意義
✤ https://technicalwriting.dev/data/embeddings.html
機器學習具備提升技術寫作的潛力，而嵌入式可能對技術寫作產生最大影響。嵌入式可幫助技術作者在以往不可能的範圍內發現文本之間的連結。
+ 技術寫作領域的專業性越來越受到重視，嵌入式的應用將為資訊傳遞與知識整合提供更強有力的支持。
+ 這篇文章深入探討了技術寫作領域中的嵌入式應用，對於想更深入瞭解其原理及潛力的讀者具有參考價值。
#技術寫作
Embeddings are underrated

GripNewsJun 8, 2024
🌘 Scipress文件 - Scipress指南
➤ Scipress - 寫作和分享內容的平臺
✤ https://www.scipress.io/post/kehluzWG8Iq9y1Nu7IMP/docs
Scipress是一個針對程序員、數學家、工程師和科學家等技術寫作者的平臺，也適用於一般用戶，提供豐富的功能，可以創建食譜書、內部知識庫、操作手冊和程式設計挑戰等內容，並可賺取費用。
+ 精簡清晰，瞭解了Scipress的功能和優勢。
+ 看完這個摘要後，對Scipress的使用方式有更清晰的認識。
#技術寫作 #平臺介紹
Scipress Docs

Scipress is a platform geared towards technical writers, enabling them to write, share, and optionally sell access to content.

GripNewsFeb 29, 2024
🌗 以Linux手冊頁形式呈現我的博客文章
➤ 使用HTTP請求獲取博客文章的Linux手冊頁
✤ https://jamesg.blog/2024/02/29/linux-manual-pages/
這篇文章介紹瞭如何將博客文章轉換成Linux手冊頁，並透過HTTP請求獲取相應版本。
+ 這篇文章清楚解釋瞭如何將博客文章轉換為Linux手冊頁，對喜歡Linux技術的讀者相當有趣。
+ 閱讀後對內容協商及NGINX配置有更深入瞭解，對技術寫作有一定幫助。
#技術寫作 #Linux
Serving my blog posts as Linux manual pages | James' Coffee Blog

Intended audience: You are likely to enjoy this post the most if you are interested in Linux and/or Linux manual pages, or if you enjoy reading about esoteric programming projects.

GripNewsDec 14, 2023
🌘 是否應該在文件中添加截圖？
➤ 截圖在文件中的優缺點
✤ https://thisisimportant.net/posts/screenshots-in-documentation/
我們討論了是否應該在文件中添加截圖，以及添加截圖的優點和缺點。截圖可能導致文件過時和增加維護成本，但當用在正確的情境下，它們可以讓讀者更容易閱讀和理解文件內容。同時，我們討論瞭如何讓截圖更易於維護和提升無障礙性。
+ 這篇文章深入探討了添加截圖的利弊，讓讀者更清楚瞭解是否在文件中使用截圖。
+ 文章指出瞭如何減少截圖的維護成本和提升無障礙性，非常實用。
#技術寫作
Should you add screenshots to documentation?

Screenshots in documentation can be a contentious topic — some people really like them and think they add a lot of value, while others dislike them due to the maintenance burden and accessibility issues. So what should you do?

GripNewsDec 13, 2023
🌘 技術寫作的來臨：佔位符
➤ 技術寫作中的佔位符技巧
✤ https://jamesg.blog/2023/12/12/technical-writing-placeholders/
文章介紹了技術寫作中使用佔位符的技巧，作者分享了在撰寫文件時使用 [add image] 或 [add code] 來代替圖片和程式碼的做法，以保持專注於寫作的技巧和效益。
+ 這些技巧有助於提高寫作效率，很實用！
+ 謝謝分享，這對於我這樣的技術寫作新手來說很有幫助。
#技術寫作
Advent of Technical Writing: Placeholders | James' Coffee Blog

This is the twelfth post in the Advent of Technical Writing series, wherein I will share something I have learned from my experience as a technical writer. My experience is primarily in software technical writing, but what you read may apply to different fields, too. View all posts in the series.

GripNewsDec 9, 2023
🌘 技術寫作的崛起：風格 | 詹姆斯的咖啡博客
➤ 技術寫作的風格和發展
✤ https://jamesg.blog/2023/12/09/style/
這篇文章講述了技術寫作中的風格，並分享了作者自己的寫作經驗和觀點，以及如何發展自己的風格。作者認為在專業寫作之外，個人寫作也可以包含幽默和俏皮的元素，並指出在教育材料中使用非正式的語言可以增加可讀性。
+ 這篇文章深入探討了技術寫作的風格，對於想要提升自己寫作能力的人來說非常有啟發性。
+ 深入淺出地解釋瞭如何在技術寫作中發展個人的風格，內容相當有趣。
#技術寫作 #風格 #咖啡博客
Advent of Technical Writing: Style | James' Coffee Blog

This is the ninth post in the Advent of Technical Writing series, wherein I will share something I have learned from my experience as a technical writer. My experience is primarily in software technical writing, but what you read may apply to different fields, too. View all posts in the series.

GripNewsDec 2, 2023
🌘 技術寫作的來臨：導航結構 | James' 咖啡部落格
➤ 技術文件的導航結構和重要性
✤ https://jamesg.blog/2023/12/02/advent-of-technical-writing/
本篇文章介紹了在技術寫作中，導航結構的重要性，包括如何選擇使用側邊欄或頂部導航欄、如何安排文件的順序、如何使用子標題來組織內容等。作者還分享了自己在撰寫技術文件時的經驗和建議。
+ 這篇文章提供了一些很好的技術寫作建議，對於需要編寫技術文件的人來說非常有幫助。
+ 導航結構對於使用者尋找需要的信息非常重要，這篇文章提供了一些建議來改善網站的導航結構設計。
#技術寫作 #導航結構 #技術文件 #網站設計
Advent of Technical Writing: Navigation Structure | James' Coffee Blog

This post was going to begin with

GripNewsNov 27, 2023
🌗 開始進入技術寫作
➤ 如何入門技術寫作，以及所需的工具和建議
✤ https://opensource.net/get-started-with-technical-writing/
技術寫作無所不在，從新手手機的使用手冊到藥物瓶上的安全說明，無處不見技術寫作的身影。大部分人都可以嘗試一下技術寫作這項技能。本文介紹了五位技術寫作專家的經驗和使用的工具。他們的建議是，不要想得太多，只要你對主題感興趣，其他人也會同樣有興趣。他們還提到了一些開放源碼的寫作工具，包括Joplin、Asciidoctor和GNU groff。當然也有許多其他的建議供大家參考。
+ 我從來沒有想過技術寫作可以這麼有趣，我會試試看的！
+ 非常感謝這些專家的分享，對於正在學習技術寫作的人來說真的很有幫助！
#技術寫作 #開放源碼
Get started with technical writing - OpenSource.net

Technical writing is everywhere. From the user manual for your new smartphone to the safety instructions on a bottle of medication, technical writing is all around us. At its best, it communicates complex technical information in a clear, concise way. And while technical writing may seem daunting, it’s a skill that most of us could […]

OpenSource.net
GripNewsOct 9, 2023
🌘 如何將文件添加到產品生命週期中
➤ 三種添加文件的模型
✤ https://thisisimportant.net/posts/process-models-for-documentation/
本文介紹了三種添加文件的模型，包括“扔到牆上”模型、“解決最新問題”模型和“我和團隊在一起”模型。每種模型都有優點和缺點，但最佳模型是“我和團隊在一起”模型，因為它可以提供以用戶為中心的文件，增加產品質量和加速內容開發。
+ 這篇文章對於技術寫作的人來說非常有用，可以幫助我們更好地瞭解如何將文件添加到產品生命週期中。
+ 很好的文章，清晰明確地介紹了添加文件的三種模型，讓人容易理解。
#技術寫作
How to add documentation to your product life cycle

An evaluation of different processes used to create documentation, and their advantages and disadvantages for the organization, the customer, and the writer.