BnosK Services

Service Introduction

BnosK 主要專長在為兩大類 (Sync, Async) 技術文件提供撰寫服務。用同步或非同步來區分,是我工作過程中的一個經驗。並不是絕對的區分。也可用佔比或是Presceiptive - Descriptive (對未來產品設計預定、對現況描述)來做區分。

研究這些不僅僅是產業別,而是有關適合的高效率正確文件流程、以及有效降低成本的作法。無論是金融業、軟體業或系統廠、製造業。我的專長是能將您的產品優點和使用、開發細節做最完整的介紹,傳遞給客戶和內部的工作人員。

這牽涉到如何做最佳的(商業)部件分群。

系統廠: 出售確切商品或零件、軟硬體部件的公司,即使是自家開發的軟體或作業系統也算。

軟體開發: 不論是SaaS、PaaS或是Micro Service都可以。只要是軟體開發

K1: 產品定位明確的公司 (Sync)

Descriptive的文件。

習慣用即時通訊或當面溝通的公司,比如營建、製造業或擁有(* 神聖 )古老文件的系統廠公司,想把所有文件整合做成線上,供內部查詢或保持更新。我們提供文件撰寫服務的同時,亦贈送已絕版的Confluence Server 正版序號。這是我過去成功的經歷,工具也可由貴司決定。亦可直接使用貴司目前的系統。比如SDL或MadCap Flare等

註: 恕不提供安裝服務。請貴司MIS安裝(雲端)啟用即可。

Confluence 7 是至今Atlassian功能最為完整的版本,而且一次啟用終身可用。對於想做數位轉型的但不確定要選什麼系統的公司來說,這是最好的低成本嘗試時機。


K2  - 適合軟體開發的文件撰寫流程 (Async)

公司已有工單系統或慣用文件系統,也有資深PM或BD,文件資訊繁多,但書面和截圖等資料統合不佳的情況。常見公司用Office 365,但新人卻習慣用Notion或Google文件導致開發資訊分散。我會選擇貴司指定的工具並集合資訊在主要一處,供您的開發和業務團隊使用。

同時也善用社群管理的經驗或巧思,讓同仁的意見或最新回報能有效率的(手動)更新進去。

以下是一些將文件實際寫在Confluence後,並去除敏感資訊後的截圖。文件可以被匯出成PDF,編輯則全部在該系統上確保現有資訊統一。


K3: Whitepaper 白皮書撰寫 

商業白皮書、Spec 。或是偏向描繪未來規畫 (Prescriptive) 的文件。

規劃的差異化參數,從中調整獲利的收入

將各參數的位置做巢狀結構標示



K4: "Doc as Code" approach 

這方法在台灣的商業環境還不是主流,我也還在研究(still in development)

For api documentation, please refer to https://www.bnosk.co/2023/01/tsmc-technical-writer.html

但他會是IT系企業的未來,或至少是隱藏在商業產品底下的文件主架構。現在有付費的拖拉管理軟體,但並不普遍,文件成形的效果也未知。

"doc as code" 會用上git flow或MD語法,甚至是直接引入如slate這樣的library。所以技術要求上難度高很多。目前我用Confluence只能做到像是這樣的程度。

 

An overview for printed doc audit log (not the system editing log)

A red flag to notify manual reader this api is new

Summary and related change log, tickets for this version

Introduction can be easily well-maintained for each project page portal


 

其他服務

S2: 一日隨同翻譯 

外賓的隨行工廠或公司現場翻譯、文化導引、秘書需求,如您有此類需求,歡迎連絡我們。針對文化差異的部分為外賓做設想,外賓不吃豬肉或牛肉? 

Technical writer並非職業的即時口譯,請見諒。這項服務是上述K系列的附加服務。還請事先預約,因本項服務無法臨時提供。

 

B2: 專案管理、公益、教育訓練性質

看膩了地產公司的說詞,想做人文地圖空拍、或街道生活圈的報導?

請直接聯繫我們,或看看我們的Youtube頻道與系列文章"尋找理想家園"。現在空拍也變得很嚴格,我不會做違規的飛行,但要申請特殊區起飛的執照並不容易。本服務完全不收費,我是不會剪輯。只是抱著認識地方、有趣、喜歡看不同地區的地貌。希望能幫一些老社區再造或為不斷變遷的都市紀錄。畢竟不管變好或變壞,世界都不可能停止改變的。

 

N1: 轉寫服務。如法律證詞文件

需要整理法律文件、零碎的檔案證據、email或條約嗎? 利用Confluence與Evernote的強大搜尋和重組片段功能。我們的靈活性能達成與您的法律事務所的合作。繁複的法律文件撰寫與證據管理。您提供檔案,我們來撰寫分析整理。當然,一切都是保密的。

可以請參考我們是怎麼做到的

( 影片 BnosK TW meetup vol.2 )

留言

Translate