Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update docs/guide.md #304

Merged
merged 2 commits into from
Apr 4, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -291,7 +291,7 @@ npm ERR! 404 tarball, folder, http url, or git url.

Node 项目遵循 [语义化版本号](https://semver.org/lang/zh-CN/) 的规则,例如 `1.0.0` 、 `1.0.1` 、 `1.1.0` 这样的版本号,本教材的主角 Vue 也是遵循了语义化版本号的发布规则。

建议开发者在入门前端工程化的时候就应该熟悉这套规则,后续的项目开发中,会使用到很多外部依赖,它们也是使用版本号控制来管理代码的发布,每个版本之间可能会有一些兼容性问题,如果不了解版本号的通用规则,很容易在的开发中带来困扰
建议开发者在入门前端工程化的时候就应该熟悉这套规则,后续的项目开发中,会使用到很多外部依赖,它们也是使用版本号控制来管理代码的发布,每个版本之间可能会有一些兼容性问题,如果不了解版本号的通用规则,很容易在开发中带来困扰

:::tip
现在有很多 CI/CD 流水线作业具备了根据 Git 的 Commit 记录来自动升级版本号,它们也是遵循了语义化版本号规则,版本号的语义化在前端工程里有重大的意义。
Expand All @@ -316,10 +316,10 @@ Node 项目遵循 [语义化版本号](https://semver.org/lang/zh-CN/) 的规则
下面以一些常见的例子帮助快速理解版本号的升级规则:

- 如果不打算发布,可以默认为 `0.0.0` ,代表它并不是一个进入发布状态的包
- 在正式发布之前,可以将其设置为 `0.1.0` 发布第一个测试版本,自此,代表已进入发布状态,但还处于初期开发阶段,这个阶段可能经常改变 API ,但不需要频繁的更新主版本号
- 在正式发布之前,可以将其设置为 `0.1.0` 发布第一个测试版本,自此,代表已进入发布状态,但还处于初期开发阶段,这个阶段可能经常改变 API ,但不需要频繁地更新主版本号
- 在 `0.1.0` 发布后,修复了 BUG ,下一个版本号将设置为 `0.1.1` ,即更新了一个修订号
- 在 `0.1.1` 发布后,有新的功能发布,下一个版本号可以升级为 `0.2.0` ,即更新了一个次版本号
- 当觉得这个项目已经功能稳定、没有什么 BUG 了,决定正式发布并给用户使用时,那么就可以进入了 `1.0.0` 正式版了
- 当觉得这个项目已经功能稳定、没有什么 BUG 了,决定正式发布并给用户使用时,那么就可以进入 `1.0.0` 正式版了

#### 版本标识符

Expand Down Expand Up @@ -801,7 +801,7 @@ hello-node
:::tip
注意, script 里的 `.mjs` 扩展名不能省略。

另外,在实际项目中,可能不需要做这些处理,因为很多工作脚手架已经帮处理过了,比如的 Vue3 项目。
另外,在实际项目中,可能不需要做这些处理,因为很多工作脚手架已经帮处理过了,比如 Vue3 项目。
:::

#### 基本语法
Expand Down
Loading