# 贡献指南

👍🎉💖 Hi，感谢你对这个项目感兴趣。💖 🎉 👍

下面是一些内容、规范等等，来帮助你更好的对这个项目进行贡献。包括但不限于：如何增加一篇新文章、如何对文章内容进行更新更正、文章的行文规范等等。当然，值得注意的是：下面这些内容仅仅是规范而非规则。欢迎来一起完善这个项目！

# 在贡献之前，我应该了解些什么？

# Code of Conduct

请先看看我们的行为准则 - Code of Conduct，并保证贡献内容符合这些规范。如果发现项目中出现了不符合这些规则的内容，欢迎反馈内容。

# 开发路线

目前 WSL 在不断更新迭代，那么本项目会尽量的跟随 WSL 的开发进行更新。包括但不限于：WSL 发行版下载方式的更新、终端的推荐更新、VSCode 本身的更新、VSCode 插件的更新等等。希望有一天，WSL 不再需要更多配置就可以无缝完美使用。

# 我应该从哪里下手？

# 反馈问题

最简单的方法就是，当你在配置过程中，出现了任何的问题，请直接去 Issue 区进行反馈。我会尽力帮助你解决问题。

# 新增内容

目前最大的障碍是针对各大语言在 WSL 下的适配工作。因此希望如果你在 WSL 中使用一个具体语言十分舒爽（比如 Ruby、Typescript、Golang、Rust、Scala 等等），可以在这里分享你的这门语言的开发环境配置过程。

如果你确定希望对本项目增加「具体语言相关的开发环境配置」教程，那么请按照下面的步骤进行贡献：

# 熟悉项目

由于项目是由 VuePress 构建，部署并托管在 Vercel 上的静态网页，因此希望你在对项目做任何改变前，先熟悉项目的结构和构建方式：

# 构建方式

在 GitHub 上 fork 一份本项目到你自己的 GitHub 账号下

将项目 clone 到你的本机：

$ git clone https://github.com/{YOUR_USER_NAME}/dowww.git

安装 Node.js 和其包管理 yarn：
- 如果你已经开始（或很想）使用 WSL 进行开发，请直接用你所选择的 Linux 发行版的包管理安装上面所述的内容。更多内容请参考 - Dev on Windows with WSL | Node.js
- 如果你依旧在使用 Windows 侧的开发环境，推荐使用 Windows 的「包管理」工具 - scoop：
  - 安装 scoop，PowerShell 中运行：
```
$ iex (new-object net.webclient).downloadstring('https://get.scoop.sh')
```
  - 安装 nvm：
```
$ scoop install nvm
```
  - 安装最新稳定版本的 Node.js：
```
$ nvm install latest
```
  - 安装 yarn：
```
$ scoop install yarn
```
- 如果你并没有在用 Windows ... 那你怎么看到这个项目了 ∑( 口 ||
安装相关依赖：
```
$ yarn install
```
本地预览：
```
$ yarn docs:dev
```

# 结构

/docs 文件夹下存放文档 Markdown 文件。文件夹名、文件名等即表示相应的文档内容；
/docs/.vuepress 文件夹下为 VuePress 的配置文件，请不要非必要情况下任意修改；

# 明确行文准则

❗ 请先明确，为了整个文档统一的格式，新增内容必须严格符合下文的行文规范。不符合的内容将会被要求修改。请谅解。

文章行文规范严格遵守中文文案排版指北中的规范准则。

详细地：

空格
- 行文时，请在中文与英文、中文与数字、英文与数字之间增加空格；
- 一段文字中有超链接的部分，在超链接的前后使用空格；
- 英文前后接全角标点符号或者表示单位的角标符号时，不需要加空格；
- 对于有特殊用法的专有名词，如 WSL、Windows 10、Ubuntu 20.04 等，英文和数字之间是否空格以官方标准为准；
- 每段文字的开头不需要空两格；
标点符号
- 不要重复使用标点符号，尤其是在表达强烈情感的时候；
- 引号请使用直角引号「」，而不是弯引号 “”；
- 一般情况下，一个中文句子中出现了英文部分，仍然使用中文标点，即全角符号；
- 如果引用一段完整的英文句子，或是出现在专有名词中的标点，则不需要更改标点符号；

我本人会对新增内容进行审核，请务必遵守上面的行文准则，当然，也要保证文章内容清晰规范。

# 增加一门语言的环境配置指南

请在 /docs/3-VSCode 下新建一个文件，命名为 3-*-***.md。其中 * 表示第几篇文章，*** 表示语言的名称，比如：3-8-AmazingLanguage.md。请在这个文件下进行文章的撰写。

撰写完成之后，请不要忘记在 docs/.vuepress/config.js 中的相应位置增加你撰写的文档路径，比如：

module.exports = [
  // ……
  {
    title: 'Visual Studio Code',
    collapsable: false,
    children: [
      // ……
      '3-VSCode/3-7-DotNetCore',
      // 你应该下面添加 3-8-AmazingLanguage 的路径
      '3-VSCode/3-8-AmazingLanguage'
    ]
  }
  // ……
]

之后，在本地构建预览：

$ yarn docs:dev

这样就可以在本地预览你的文章了。

一般情况下，到这里就可以了，在本地写好文章之后将新增内容 push 到 GitHub 并提交 PR，我就会将你的新增内容更新至文档中。

# 其他

其他内容的增加和更改，请直接修改你想要修改的地方，我会根据更改选择是否 merge 你的内容。