該存儲庫保存用於構建.NET入門教程的內容,該教程在http://dot.net上託管
內容按主題分解為高級組,最初涵蓋
在每個內容區域內,都有一個或多個教程。
每個教程都由課程組成。每個課程都應是一個頁面,詳細介紹所教授的概念以及示例代碼。在描述教程時,可以互換使用課程和頁面。課程可以分為幾個步驟。每個步驟和課程都應以用戶可以使用REPL,Visual Studio或Visual Studio代碼運行的工作代碼結尾。
您可以將C#內容視為其他內容領域的模型。請注意,URL/鏈接應使用“ CSHARP”代替C#,因為GitHub會將後者轉換為C%23,從而導致鏈接破裂。另請注意,在GitHub的Web視圖中,鏈接到readme.md文件對病例敏感。
課程將包括將根據讀者背景標記的技巧,最終將向讀者展示這些技巧。例如:
tip {.tip .vb} c#中的靜態關鍵字等效於在Visual Basic .NET中共享
課程還將包括筆記,當向讀者展示時,這些筆記將獲得特殊的格式。例如:
通常會記錄發生的例外,因此您可以在以後進行審查並改進程序以避免使用程序(如果可能)。
課程將使用Markdown(GitHub變體)編寫。課程應鏈接到其他文檔,以進行特定任務和API參考。這些應該專注於幫助用戶遵循並理解教程。
最終的發布平台功能和要求尚不清楚。除非它們為止,否則我們沒有適當的系統包含或在教程/頁面上共享共同元素。現在,我們需要復制/粘貼。
主分支將包含最新批准的內容。在短期內,批准的內容作者將被允許直接推向主人。但是,一旦有大量內容,就可以期望作者在提交拉動請求並等待另一個團隊成員的A之前在自己的功能分支中工作。
我們歡迎對這些教程的貢獻和更正。我們將在我們要接下來要解決的領域的不久之後建立路線圖,但會向我們發送您的想法。貢獻步驟是:
我們要求重大變化的作者簽署了.NET基金會貢獻許可協議。該項目採用了貢獻者盟約定義的行為準則,以闡明我們社區的預期行為。有關更多信息,請參見.NET基金會行為守則。
該項目得到了.NET基金會的支持。