# 贡献指南
我们鼓励每个人为Windows 12网页版贡献内容。

若您想贡献本仓库，那您必须仔细阅读本指南的所有内容。您还应当注意本指南中**加粗的文字**和[开发规范](#开发规范)章节的内容。

## 基本流程

下面是贡献 pull request（下文中简称“PR”）所需的基本步骤。

1. 您可以寻找可改善的任何东西，代码逻辑、格式规范或是页面内容等进行改进。

2. 然后Fork本仓库,将其Clone到本地。

3. 在本地进行修改，完成后Commit。（请尽量一次Commit提交全部内容。可以追加Commits，但尽量不要超过5个Commits。）

4. 将修改推送到您的仓库

5. 再[创建一个Pull Request](https://github.com/tjy-gitnub/win12/pulls)。

6. 然后`坐和放宽`，等待其他人对你的代码进行审查。
>[!TIP]
>在此过程中请尽量使用Git命令行、Github Desktop、[https://github.dev](https://github.dev/tjy-gitnub/win12)等方式进行提交。

## 重要提醒
* 若您的修改具有一定重要性或量级时，请按照以下格式阐述更新内容：

      ```
      v11.4.5 - 更新了xxx

      (更新来自 @Somebody)
      - 更新了...
      - 优化了...
      - 修复了...
      ...
      ```

>[!TIP]
>  1. 标题要带有版本号、主要更新内容。
>  2. 内容第一行注明更新来源。
>  3. 内容要用列表的方式阐述更新内容。

>[!NOTE]
>  1. **请不要**任意选取版本号。若您不清楚，可以通过[我们的交流群](https://teams.live.com/l/invite/FEA0yrNkE_bAn-ddwI)与我们取得联系并分配到版本号。
>  2. 在更新时，**记住**要在“关于 Windows 12 网页版”应用的更新记录中，添加关于该更新的相关内容。

* 根据中华人民共和国有关法律的规定您**不可以**通过本项目传播违法和违规内容，否则我们将会采取锁定+视情况封禁的处理（温馨提示：时事新闻也不行），同时我们保留在任何时间以一切方式采取法律行动、追究法律责任的权利。

* 贡献此项目，则代表您知情并同意：为使得您贡献的内容得到更好的分享及推广，就您在本项目所贡献的内容，您授权我们一项全球范围内的、免费的、非独家的、可再许可的权利；该等内容包括但不限于文字作品、美术作品、图形作品、视听作品、计算机程序源代码等各种著作权法意义上构成“作品”的内容；该等权利包括但不限于复制、翻译、整理、汇编、注释、改编、信息网络传播、发行等各项著作权及其相关权利，且该等权利应至少涵盖对于“Windows12 网页版”项目或以其他方式开发相关内容的一部分或全部的权利及许可。

### 开发规范

1. 对于HTML文件的规定

   详见 `desktop.html` 开头的代码规范，务必认真阅读。

2. 对JS文件的规定

   1. 请按照以下代码风格进行开发：

   ```js
      var sum = 0;
      for (var i = 0; i < 10; i++) {
         sum += i;
      }
      console.log(sum);
   ```

   2. 对于函数名及变量命名，请使用驼峰式命名法，如：

      - isLoaded

      - storagedItems

   3. 对于类名，请使用帕斯卡命名法（大驼峰式命名法），如：

      - WindowManager

      - Widgets

   4. 对于代码规范的规定：

      对于那些不需要展开的代码，尽量压成一行