Table of contents

貢獻指南

感謝所有為本項目做出貢獻的開發者和大家的支持!

如果您喜歡本項目,歡迎給這個項目點一顆Star、給我們贊助一下或為我們做出一些重要的貢獻qwq~

請不要提交無意義的PR哦~這裡點名批評: image

漏洞彙報

  1. 請使用最新版本,以確認該漏洞是否已經被修復。

  2. 請確認該漏洞或錯誤是不是屬於您所使用的問題。如,使用較為老旧的瀏覽器(如IE等)、關閉了瀏覽器部分特性(如禁止存儲數據等)

  3. 請清楚地描述漏洞,以便我們更好地進行修復。

  4. 您可以使用「漏洞彙報」Issue模板進行反饋,但請正確地填寫其中的內容。

  5. 禁止在內容中添加任何違反法律或政治敏感的內容,否則將會採取鎖定+視情況封禁的處理。

提出建議

  1. 請使用最新版本,以確認該建議是否已被實現/解決。

  2. 請清楚地描述建議,以便我們更好地進行實現/解決。

  3. 您可以使用「提出建議」Issue模板進行反饋,但請正確地填寫其中的內容。

  4. 禁止在內容中添加任何違反法律或政治敏感的內容,否則將會採取鎖定+視情況封禁的處理。

提交代碼

注意:請嚴格按照下面的,以及desktop.html開頭的開發規範編輯代碼,否則不予合併

  1. 請盡量一次Commit提交全部內容。可以追加Commits,但盡量不要超過5個Commits。

  2. 請盡量使用Git命令行、Github Desktop、https://github.dev等方式進行提交。請不要直接在瀏覽器中上傳文件來提交。

  3. 禁止上傳任何違反法律或政治敏感的內容,否則將會採取鎖定+視情況封禁的處理(溫馨提示:時事新聞也不行)。

  4. 提交時請不要隨意取提交標題及內容,例如:

    • 好的例子:修復xx無法正常使用的問題、新增xx應用

    • 壞的例子:阿巴阿巴、這個玩意忘弄了、bug太多了…qwq

  5. 格式化要求:

    • 請不要使用格式化工具格式化HTML文件

    • 對於JavaScript和CSS文件,可以使用Visual Studio Code自帶的格式化工具格式化

提交信息要求

  1. 若更新具有一定重要性或量級時,請按照以下格式:

    v11.4.5 - 更新了xxx
    
    (更新來自 @Somebody)
    - 更新了...
    - 優化了...
    - 修復了...
    ...
    
    • 使用該格式的要求:

      1. 該更新提交前必須告知我們。
    • 說明:

      1. 標題要帶有版本號、主要更新內容。

      2. 內容第一行註明更新來源。

      3. 內容要用列表的方式闡述更新內容。

    • 注意:

      1. 請不要任意選取版本號。若您不清楚,可以通過我們的交流群與我們取得聯繫(https://teams.live.com/l/invite/FEA0yrNkE_bAn-ddwI)並分配到版本號。

      2. 在更新時,記住要在「關於 Windows 12 網頁版」應用的更新記錄中,添加關於該更新的相關內容。

  2. 若滿足下列條件,提交內容不作過於標準的規定:

    • 更新內容較少。

    • 更新內容沒有重要的更改。

    儘管沒有標準的規定,但仍然需要:

    1. 提交標題應當清晰明了,能簡要概括更新的主要內容。

    2. 提交內容應當註明提交者,並以列表或其他方式進行對本次更新內容的闡述。

開發規範

  1. 對於HTML文件的規定

    詳見 desktop.html 開頭的代碼規範,務必認真閱讀。

  2. 對JS文件的規定

    1. 請按照以下代碼風格進行開發:
       var sum = 0;
       for (var i = 0; i < 10; i++) {
          sum += i;
       }
       console.log(sum);
    
    1. 對於函數名及變量命名,請使用駝峰式命名法,如:

      • isLoaded

      • storagedItems

    2. 對於類名,請使用帕斯卡命名法(大駝峰式命名法),如:

      • WindowManager

      • Widgets

    3. 對於代碼規範的規定:

      1. 對於那些不需要展開的代碼,盡量壓成一行