貢獻指南
感謝所有為本項目做出貢獻的開發者和大家的支持!
如果您喜歡本項目,歡迎給這個項目點一顆Star、給我們贊助一下或為我們做出一些重要的貢獻qwq~
請不要提交無意義的PR哦~這裡點名批評:
漏洞彙報
-
請使用最新版本,以確認該漏洞是否已經被修復。
-
請確認該漏洞或錯誤是不是屬於您所使用的問題。如,使用較為老旧的瀏覽器(如IE等)、關閉了瀏覽器部分特性(如禁止存儲數據等)
-
請清楚地描述漏洞,以便我們更好地進行修復。
-
您可以使用「漏洞彙報」Issue模板進行反饋,但請正確地填寫其中的內容。
-
禁止在內容中添加任何違反法律或政治敏感的內容,否則將會採取鎖定+視情況封禁的處理。
提出建議
-
請使用最新版本,以確認該建議是否已被實現/解決。
-
請清楚地描述建議,以便我們更好地進行實現/解決。
-
您可以使用「提出建議」Issue模板進行反饋,但請正確地填寫其中的內容。
-
禁止在內容中添加任何違反法律或政治敏感的內容,否則將會採取鎖定+視情況封禁的處理。
提交代碼
注意:請嚴格按照下面的,以及desktop.html開頭的開發規範編輯代碼,否則不予合併
-
請盡量一次Commit提交全部內容。可以追加Commits,但盡量不要超過5個Commits。
-
請盡量使用Git命令行、Github Desktop、https://github.dev等方式進行提交。請不要直接在瀏覽器中上傳文件來提交。
-
禁止上傳任何違反法律或政治敏感的內容,否則將會採取鎖定+視情況封禁的處理(溫馨提示:時事新聞也不行)。
-
提交時請不要隨意取提交標題及內容,例如:
-
好的例子:修復xx無法正常使用的問題、新增xx應用
-
壞的例子:阿巴阿巴、這個玩意忘弄了、bug太多了…qwq
-
-
格式化要求:
-
請不要使用格式化工具格式化HTML文件
-
對於JavaScript和CSS文件,可以使用Visual Studio Code自帶的格式化工具格式化
-
提交信息要求
-
若更新具有一定重要性或量級時,請按照以下格式:
v11.4.5 - 更新了xxx (更新來自 @Somebody) - 更新了... - 優化了... - 修復了... ...
-
使用該格式的要求:
- 該更新提交前必須告知我們。
-
說明:
-
標題要帶有版本號、主要更新內容。
-
內容第一行註明更新來源。
-
內容要用列表的方式闡述更新內容。
-
-
注意:
-
請不要任意選取版本號。若您不清楚,可以通過我們的交流群與我們取得聯繫(https://teams.live.com/l/invite/FEA0yrNkE_bAn-ddwI)並分配到版本號。
-
在更新時,記住要在「關於 Windows 12 網頁版」應用的更新記錄中,添加關於該更新的相關內容。
-
-
-
若滿足下列條件,提交內容不作過於標準的規定:
-
更新內容較少。
-
更新內容沒有重要的更改。
儘管沒有標準的規定,但仍然需要:
-
提交標題應當清晰明了,能簡要概括更新的主要內容。
-
提交內容應當註明提交者,並以列表或其他方式進行對本次更新內容的闡述。
-
開發規範
-
對於HTML文件的規定
詳見
desktop.html
開頭的代碼規範,務必認真閱讀。 -
對JS文件的規定
- 請按照以下代碼風格進行開發:
var sum = 0; for (var i = 0; i < 10; i++) { sum += i; } console.log(sum);
-
對於函數名及變量命名,請使用駝峰式命名法,如:
-
isLoaded
-
storagedItems
-
-
對於類名,請使用帕斯卡命名法(大駝峰式命名法),如:
-
WindowManager
-
Widgets
-
-
對於代碼規範的規定:
- 對於那些不需要展開的代碼,盡量壓成一行