衡量一個優(yōu)秀的開源項目，除了高質(zhì)量的代碼，還包括新功能開發(fā)、迭代維護(hù)，社區(qū)交流、推動項目在社區(qū)中的使用，提供高質(zhì)量的文檔體系和一定程度的技術(shù)答疑等。RT-Thread作為一款受開發(fā)者青睞的開源物聯(lián)網(wǎng)操作系統(tǒng)，在13年的發(fā)展中一直堅持“開源、開放”的理念，充分和社區(qū)用戶交流，穩(wěn)定維護(hù)代碼的更新迭代，不斷完善優(yōu)化技術(shù)文檔，并且提供了活躍的社區(qū)技術(shù)支持，助力開發(fā)者更高效率地進(jìn)行產(chǎn)品開發(fā)。
尤其在近兩年，RT-Thread官方團(tuán)隊在文檔中心的建設(shè)上付出了巨大的努力，取得豐碩成果的同時，也與開發(fā)者建立了良性互動。2019年伊始，我們經(jīng)過多輪意見征詢和精心準(zhǔn)備，對RT-Thread文檔中心進(jìn)行了全面升級，為初學(xué)者和開發(fā)者帶來更優(yōu)質(zhì)的學(xué)習(xí)和使用體驗。
新版在線文檔中心即日上線：https://www.rt-thread.org/document/site/
RT-Thread新版文檔中心在上線之前，經(jīng)過了多次開發(fā)與迭代。從學(xué)習(xí)路徑、功能模塊、實(shí)際應(yīng)用、文檔結(jié)構(gòu)等方面入手，做了大量的優(yōu)化，進(jìn)一步提升了文檔質(zhì)量，增加豐富了文檔內(nèi)容，真正形成了較為完整的文檔體系。針對之前反應(yīng)的一些主要問題，如文檔較為散亂等，也重新梳理了學(xué)習(xí)路線、重整了文檔架構(gòu)，降低了入門門檻。新版文檔中心的主要特性如下：
更加清爽直接的UI界面
如上圖所示，RT-Thread新版文檔中心主要分成了入門學(xué)習(xí)、進(jìn)階學(xué)習(xí)、應(yīng)用開發(fā)三大版塊，清爽直接一目了然。而側(cè)標(biāo)題欄，則采用了不同的分類方式，有利于大家尋找更加細(xì)化的內(nèi)容。
更貼合用戶需求的學(xué)習(xí)路線規(guī)劃
針對用戶基礎(chǔ)水平參差不齊的情況，我們?yōu)橛脩糇隽诵碌膶W(xué)習(xí)路線規(guī)劃參考。明確了用戶在不同階段的學(xué)習(xí)目的，避免用戶在學(xué)習(xí)過程中產(chǎn)生漫無目的困擾，最大程度地降低了學(xué)習(xí)成本。概況如下：
入門：目標(biāo)是把RT-Thread跑起來，并且完成內(nèi)核部分的學(xué)習(xí)。
進(jìn)階：目標(biāo)是會使用Env工具，會使用RT-Thread外設(shè)、組件、軟件包。
應(yīng)用：目標(biāo)是能將RT-Thread應(yīng)用于自己的項目中。
大幅度降低入門難度
盡力降低初學(xué)者的學(xué)習(xí)門檻，讓入門變得快速而簡單，是我們始終努力的目標(biāo)。初學(xué)者分三步走，即可在數(shù)小時內(nèi)輕松上手RT-Thread。
1.可以在不使用開發(fā)板的情況下模擬運(yùn)行RT-Thread，體驗RT-Thread內(nèi)核和FinSH命令行功能。
2.可以根據(jù)不同的基礎(chǔ)選擇一塊學(xué)習(xí)板，根據(jù)各種學(xué)習(xí)開發(fā)板的上手指南，快速將RT-Thread運(yùn)行起來。
3.根據(jù)《內(nèi)核視頻教程》和《RT-Thread編程指南》系統(tǒng)學(xué)習(xí)RT-Thread內(nèi)核。
更加豐富且體系化的文檔
新版編程指南在老版內(nèi)容的基礎(chǔ)上，重新進(jìn)行了修訂，并且加入了很多新內(nèi)容。豐富為現(xiàn)在的30章，包含了內(nèi)核、外設(shè)、組件等各方面的內(nèi)容，支持在線查看的同時也可以下載pdf電子版。
新增了RT-Thread API手冊，用戶可以對API進(jìn)行快速的查找。它包含RT-Thread所有API，并且API根據(jù)模塊歸類劃分，同時也包含了數(shù)據(jù)類型、結(jié)構(gòu)體、宏定義和API的使用示例等內(nèi)容，除了在線查看，也可以下載chm電子書版本。
還針對應(yīng)用開發(fā)，新增各類應(yīng)用筆記和一些重要的軟件包相應(yīng)的用戶手冊。
最后，歡迎大家使用RT-Thread全新版在線文檔中心，并幫忙反饋問題和給出建議，一起讓RT-Thread越來越好！也感謝大家多年來的無私奉獻(xiàn)和支持！我們的目的從來不止于做開發(fā)者的寵兒，而是做陪你一起進(jìn)步成長的良友。