This page is a machine translation of the Japanese text. Please contact faunsu https://twitter.com/faunsu19000 or symbol-community.com/community for language proofreading of articles.
大家好!連續三個月,我每次都承諾這會是最後一篇 Symbol 文件報告……但這一次我真的認為是最後一次了。
Symbol 文件撰寫工作已經正式完成。
(計畫發布產品的使用者指南目前仍處於保留狀態,但無論從倫理還是我的良心來說,我都會在之後補充。)
那麼,以下帶來關於 Symbol 文件的最終報告、關於 NEM 文件的新系列報告的開端,以及……回歸遊戲開發模式。
已完成工作的概要
內容撰寫 Jaguar 對新的 Symbol 文件網站進行了徹底審閱,我花了整整一個月逐一查看他留下的評論。
其中有些評論指出了技術問題(這是我的失誤!),也有很多聚焦於寫法或提出改善建議。數量相當多。
審閱花費的時間比預想更長,但結果是文件品質大幅提升,終於達到了可以作為官方 Symbol 文件發布的狀態。
例如,在開發者手冊的入口頁面中,教學現在會按難度分類,因此初學者更容易找到合適的起點。
審閱 開發者頁面(task-docs-dev) Zero 已經開始製作新的 NEM 文件網站,我正在按收到的內容依次進行審閱。目前進行中的工作可以在這裡查看。
該網站與新的 Symbol 文件採用相同結構,由使用者手冊、開發者手冊以及補充它們的教材組成。教材已經完成,目前工作已轉向教學撰寫。
由於 Symbol SDK 同時支援 Symbol 和 NEM 兩條區塊鏈,大多數 NEM 教學與 Symbol 教學非常相似,因此我預計工作會迅速推進。 🤞🏻
DARUMA STUDIO 5月我總算設法安排出時間,花了整整兩天處理 XYM City 的遊戲設計文件。
Symbol 文件審閱終於結束了,我期待未來幾個月這個數字能大幅增加... 💃🏻
網站結構 ⚙️ Jaguar 的一些審閱評論需要對網站底層基礎設施進行大幅修改。
對本以為已經完成的東西進行重構,會帶來格外的痛苦。不過痛苦是暫時的,Git 會永遠留下。我一邊這樣告訴自己,一邊繼續工作。教學系統現在包含以下內容:
- 為各教學添加標籤,並在開發者手冊入口頁面自動生成排序表的複雜度 metadata 標籤。
- 採用命名程式碼片段,而不是基於行號的引用,這樣原始碼可以持續演進,而無需不斷更新片段範圍。
- 教學文本中的變數名稱現在會根據所選擇的程式語言自動適配。方法名稱和類別名稱以前已經可以這樣做,但變數尚未支援。
學習 🤖 Hatchet 建議我們掌握最新的 AI 輔助工作流程。
以前我就一直大量使用 ChatGPT 來潤飾自己的文章(抱歉!英語不是我的母語),但從這個月開始,我又向前邁了一步,在 VS Code 中導入了 Codex。
在網站重構過程中,它被證明非常有用。擁有一個能夠理解整個文件儲存庫結構的助手,顯然是一項優勢。
不過,我仍然相當嚴格地管理它。也許我有點被害妄想,但我不打算讓它在未經我確認的情況下提交任何內容。
下面是本月各項任務的相對時間分配:
文件進展情況
Symbol Symbol 文件已經正式完成。剩餘工作只有為了在最終 URL 上發布而進行的網站準備。
當然,文件永遠不會完全完成。隨著新產品和新功能的開發,新的指南也會不斷追加。
這將是最後一次進度圖表發布……請看看這條美麗的 100% 進度條。 🥲
NEM 從下次開始,我將改為報告 NEM 文件。 我決定簡化這一部分。對讀者來說更容易閱讀,對我來說則是因為……製作上面的圖比預想花了更多時間😅
情況可以很簡單地看出來。計畫中的 NEM 文件撰寫任務中,已有 25% 完成或正在進行。
下一步計畫
繼續審閱 Zero 關於 NEM 文件的工作
終於有了回報。我終於可以回到 XYM City 的設計中
我離像孩子一樣的 XYM City 太久了,真的很想念它!
即使不包括角色設定、任務設計和劇本,你們能相信遊戲設計文件已經接近 40 頁了嗎?
今後我也會報告這項工作,但會注意不要劇透太多。 🙂
感謝閱讀到這裡。下個月再見!