關于(yú)規範FAST文檔和(hé / huò)代碼版本的(de)通知
發布時(shí)間:2018-08-16
自從2018年6月推出(chū)OpenBox-S4z平台後,基于(yú)OpenBox-S4z/FAST的(de)解決方案已經在(zài)國(guó)防科技大(dà)學、清華大(dà)學、北京大(dà)學、電子(zǐ)科技大(dà)學等單位的(de)教學和(hé / huò)科研活動中得到(dào)應用,涉及到(dào)計算機網絡教學實驗、新型路由交換(段路由)設備原型、工業互聯網交換設備原型、網絡安全防護設備原型和(hé / huò)網絡測試儀原型的(de)研發。
随着用戶數不(bù)斷增加,用戶開發水平不(bù)斷提升,應用開發類型不(bù)斷豐富,FAST平台的(de)一些深層次問題逐漸顯現。一是(shì)設計文檔不(bù)完善,用戶無法從文檔中獲取必要(yào / yāo)的(de)信息;二是(shì)設計文檔與代碼不(bù)對應,給用戶開發帶來(lái)困擾;三是(shì)軟硬件代碼設計存在(zài)Bug,運行不(bù)穩定;四是(shì)代碼版本管理混亂,降低開發和(hé / huò)服務的(de)效率。
爲(wéi / wèi)了(le/liǎo)解決上(shàng)述問題,FAST社區拟開展以(yǐ)下工作。
一、建立和(hé / huò)維護Bug清單
集中管理不(bù)同(單位)用戶在(zài)FAST平台開發中遇到(dào)的(de)問題,設置并維護Bug清單。
用戶可通過郵件或在(zài)FAST社區内提交Bug,Bug清單及修複狀态在(zài)FAST網站和(hé / huò)公衆号平台定期發布。FAST平台提供商和(hé / huò)服務提供商負責相關Bug的(de)确認及修複。
二、強化版本管理
明确區分FAST的(de)研發版本與發布版本,避免出(chū)現不(bù)同的(de)代碼分支,造成代碼版本管理混亂,降低開發和(hé / huò)服務的(de)效率。
FAST平台提供商在(zài)FPGA OS和(hé / huò)FAST支撐軟件中設置版本标識,FAST服務商提供FAST硬件流水線和(hé / huò)FAST庫的(de)版本标識,爲(wéi / wèi)用戶提供讀取各類版本标識的(de)方法。
隻有通過内部測試的(de)代碼版本才能成爲(wéi / wèi)發布版本,用戶從唯一的(de)網址下載FAST發布的(de)軟硬件代碼。
以(yǐ)後FAST的(de)所有軟硬件代碼及文檔均隻能從網站固定位置下載更新,不(bù)再通過其他(tā)方式交互。
三、設置常見問題列表
針對FAST論壇中用戶提出(chū)的(de)各類問題以(yǐ)及回複,整理常見問題(FAQ)列表,供其他(tā)用戶參考。
歡迎FAST用戶對以(yǐ)上(shàng)工作安排提出(chū)寶貴意見,上(shàng)述工作的(de)實施細則将會在(zài)近期公布。爲(wéi / wèi)做好以(yǐ)上(shàng)工作,2018年8月20日後,請所有FAST用戶從FAST網站下載代碼和(hé / huò)文檔,FAST技術支持團隊不(bù)再通過線下直接向用戶提供代碼和(hé / huò)文檔。