🌕 Red Hat 撰寫與編輯風格慣例
➤ 確保 Red Hat 文件的一致性和高品質
https://stylepedia.net/style/
本文件為 Red Hat 技術寫作風格指南第 7.1 版,涵蓋文法、設計、用字遣詞等各項規範,旨在為 Red Hat 的培訓、認證及技術文件提供統一的風格標準。本指南不僅提供日常標點符號與文法的指導,也著重翻譯、全球化內容設計,並包含術語詞典。它是一個公開且不斷更新的指南,接受社羣貢獻。本版本新增了關於人工智慧、邊緣運算等新術語的定義,並更新了相關規範。
+ 這份指南非常詳盡,對於需要撰寫 Red Hat 相關技術文件的寫作者來說,絕對是不可或缺的參考資料。
+ 很好,Red Hat 願意公開分享他們的風格指南,這有助於提升整個技術文件的品質。
#技術文件 #風格指南 #Red Hat
Style Conventions for Writers and Editors

The Red Hat Technical Writing Style Guide and Word Usage Dictionary is a joint effort by various groups within Red Hat. It is intended as a supplement to the titles listed in

🌗 s-expr.md · GitHub
➤ 突破傳統的S-expression語法革新
https://gist.github.com/tearflake/569db7fdc8b363b7d320ebfeef8ab503
S-expr 解析庫的技術規格文件,說明其獨特的S-expression語法擴展
+ 轉置區塊概念真巧妙!終於能擺脫Lisp滿屏括號的噩夢了
+ 多行字串的矩形邊界設計雖然嚴謹,但實作時會不會太麻煩?
##程式語言 #技術文件
s-expr.md

GitHub Gist: instantly share code, notes, and snippets.

Gist
🌕 首頁 - Spark
➤ 3D Gaussian Splatting 渲染新選擇
https://sparkjs.dev/
Spark 是一個專為 THREE.js 設計的進階 3D Gaussian Splatting 渲染器。它支援多種格式的檔案載入 (ply, spz, splat, ksplat),能在所有裝置上快速渲染,並提供可程式化的動態斑點效果。Spark 旨在與其他網格和斑點整合,方便使用者在場景中運用。
+ 這看起來像是一個很有潛力的 THREE.js 渲染工具!渲染速度快而且支援多種格式,太方便了。
+ 終於有針對 3D Gaussian Splatting 的開源渲染器了,對於想在網頁上實現高品質 3D 視覺效果的人來說,這真的是個好消息。
#3D 圖形渲染 #技術文件
Spark

An advanced 3D Gaussian Splatting renderer for THREE.js

🌘 美國萬象科技 AMIBIOS 程式設計師指南
➤ AMIBIOS 深入解析:硬體與軟體整合的技術指南
http://bitsavers.org/pdf/americanMegatrends/Programmers_Guide_to_the_AMIBIOS_1993.pdf
本文件是美國萬象科技(American Megatrends, Inc.)出版的 AMIBIOS 程式設計師指南,涵蓋了 PCI、APM、Socket 服務以及 BIOS 函數的描述。它詳細介紹了 AMIBIOS 的各個方面,包括功能、設置、系統記憶體、BIOS 資料區、I/O 端口位址、開機自檢程序、中斷使用和 BIOS 軟體中斷等,並提供了相關的表格和技術細節。同時,文件也明確了版權限制和責任聲明。
+ 這本書對於需要深入瞭解 BIOS 設定和程式設計的人來說,是一份非常有價值的參考資料。
+ 雖然內容較為技術性,但對於電腦硬體愛好者或開發者來說,可以幫助他們更好地理解電腦的啟動過程和底層操作。
#電腦硬件 #BIOS #技術文件
🌘 Slidev 文件
➤ 為開發者打造的簡報利器
https://sli.dev
Slidev 是一個為開發者設計的簡報工具,它採用了簡潔的語法和強大的客製化能力。本文件涵蓋了 Slidev 的各個方面,包括入門指南、語法說明、使用者介面介紹、動畫與主題擴充功能、元件、版面設計、匯出、部署、常見問題、進階設定以及資源展示等。使用者可以透過本文件學習如何撰寫版面設計、主題和擴充功能,並瞭解 Slidev 的內建功能和 CLI 工具的使用方法。
+ 「這份文件非常詳細,涵蓋了 Slidev 的所有功能,即使是初學者也能快速上手。」
+ 「Slidev 看起來很有潛力,能用程式碼的方式來製作簡報真的太酷了!」
#開源專案 #簡報工具 #技術文件
Slidev

Presentation slides for developers

🌘 寫作技巧:教學,別只是告訴
➤ 技術文件的重要性與寫作技巧
https://stevelosh.com/blog/2013/09/teach-dont-tell/
這篇文章探討撰寫技術文件的藝術,特別是針對程式語言和程式庫的文件。作者強調好的文件應該具備教學性,幫助閱讀者理解並成為專家使用者,提供了撰寫良好文件的建議和技巧。
+ 撰寫好的文件確實需要耐心和技巧,教學和引導讀者更是不容忽視的重要一環。
+ 從作者的觀點來看,確實感受到了撰寫技術文件的挑戰之處,也讓人更加重視良好文件的價值。
#技術文件 #程式語言 #教學
Teach, Don't Tell / Steve Losh

🌗 hyveOS - 管理無人機和機器人
➤ hyveOS 的優勢在於去中心化方式協調各種機器,讓應用程式開發者無需在意網路或伺服器。
https://docs.p2p.industries
hyveOS - 管理無人機和機器人。無需網路連接或樂音伺服器,以完全去中心化方式協調機器人、無人機或任何基於debian的機器!
+ 這個系統看起來讓協調無人機和機器人變得更有效率!
+ 聽起來就像是未來科技的一大步前進。
#技術文件
hyveOS - Orchestrate drones and robots

Get started using the data functionality in your inter-robot network.

hyveOS docs
🌘 DoxyPress: 簡介
➤ DoxyPress 1.7.0 技術文件概述
https://www.copperspice.com/docs/doxypress/index.html
這份文件介紹了 DoxyPress 1.7.0 的主要內容,包括安裝、使用方式、功能特色、常見問題等詳細資訊。文中提到的 DoxyPress 與 CopperSpice 詳細介紹可參考官網。
+ 這份簡介很清楚明瞭,對於該軟體的使用和相關資訊有了更深入的瞭解。
+ 總結得很好,提供了相關連結和版權資訊,方便使用者獲取更多資訊。
#技術文件
DoxyPress: Introduction

🌗 MyST Markdown工具 - MyST Markdown介紹
➤ MyST Markdown的魅力和特色
https://mystmd.org/guide
MyST是一系列開源、社羣驅動的工具生態系統,旨在革新科學交流。支持博客、線上書籍、科學論文、報告和期刊文章等。功能夥伴實用指南供快速上手;深入功能包括快速查找引導、嵌入活潑圖表和支援JupyterLab等特色;給予信用並下載MyST Markdown工具。
+ 這段摘要清楚地表達了MyST Markdown的功能和重要性,讓人對這個工具有更深入的瞭解。
+ 精簡明瞭的條列式摘要讓人一目瞭然,充分呈現了MyST Markdown工具的價值。
#技術文件
MyST Markdown Tools - MyST Markdown

MyST (Markedly Structured Text) is designed to create publication-quality documents written entirely in Markdown.

🌘 nips/01.md at master · nostr-protocol/nips · GitHub 中文翻譯
➤ NIP-01:基本協議流程描述草案
https://github.com/nostr-protocol/nips/blob/master/01.md
這份文件定義了基本通訊協議,包括事件和簽名,以及標籤等,並說明瞭如何序列化事件和使用標籤。此外,還討論了事件的類型和意義,以及不同類型事件應如何處理。
+ 這份文件很清楚地解釋了事件處理的步驟,對於通訊協議有很好的概括。
+ 詳細說明瞭如何處理不同類型的事件和標籤,對於程式開發者來說很有用。
#技術文件
nips/01.md at master · nostr-protocol/nips

Nostr Implementation Possibilities. Contribute to nostr-protocol/nips development by creating an account on GitHub.

GitHub