最近,我們推出了.NET MAUI Community Toolkit,並且現在已做好了接受社群貢獻的準備。
我們修改了新增新功能的工作流程,在此分享給各位,以方便大家今後繼續完善,做出貢獻。
我們還為此建立了一個專案看板,以便您在這裡跟蹤新的工作流程:
新功能工作流程
新功能工作流程在很大程度上受到了C#團隊當前工作流程的啟發,能夠優化其Discussions and Proposals的實施。
展開討論
所有的新功能都將以討論的形式開始。
作為一個社群,我們可以在此討論新功能的優點和缺點,確定它的範圍,它的API表面的形態,並就其實施達成共識。
開啟新功能提案
一旦某個新功能的實施在討論中達成一致,就可以提交新功能提案了。
新功能提案是相當深入的,需要以下資訊:
- 摘要
- 詳細設計
- 使用句法(XAML的用法和C#的用法)
- 缺點
- 替代方案
- 未解決的問題
提案負責人
在出現一個新提案後, .NET MAUI Community Toolkit 團隊的一名成員將被選為負責人,意味著該團隊成員同意將其納入.NET MAUI Community Toolkit,他們將在下一次 .NET MAUI Community Toolkit 月度討論會上對該提議進行投票。
在每個月的第一個星期四下午12點,我們會在.NET基金會的YouTube頻道上直播我們的會議,除此之外,我們會對新功能提案進行投票。如果某個提案得到核心團隊50%以上的支援,它就被正式批准了。
批准提案
一旦提案被批准,就終於到了開始寫程式碼的時候了。
在該階段,我們將把提案分配給任何願意為之做出貢獻的社群成員。
請在任何提案上留下評論,標記為需要幫助,我們會很高興地把它分配給你。
我們要求每個Pull Request在合併前包括以下專案:
- 實施
- iOS 支援
- Android 支援
- macOS 支援
- Windows 支援
- 單元測試
- 示例
- XML文件
批准Pull Request
在這一步,程式碼已經完成,包括單元測試、XML文件和 .NET MAUI Toolkit 示例應用中包含的內容。
現在唯一阻礙該Pull Request被合併的是Microsoft文件GitHub庫中的官方文件的完成情況。由於官方文件在不同的倉庫中,我們新增了待定文件標籤,以確保我們一定會完成此文件。
我們要求Pull Request的作者也參與編寫該功能的官方文件,因為你是最瞭解該功能的人。當然,如果你的英語不好,我們也很樂意幫你審閱編輯。
批准文件
文件完成後,將由.NET MAUI Community Toolkit團隊的成員進行審查、批准和合並。
文件完成後,就可以合併該Pull Request了。
完成
終於完成了。 Pull Request已被合併,正式將你的程式碼新增到 .NET MAUI Community Toolkit中。
另外,我們還為大家準備了 .NET 6 和 Visual Studio 2022 的技術乾貨合集!全新的整合開發環境、多項改進以及配套資源上新,為開發者們帶來生產力的提升和工作質量的改善。