Merge pull request #14 from sunface/main

sync
3 years ago · 4a9dc1e716
parent 848f1778c9 acc8727626
commit 4a9dc1e716
5 changed files with 6 additions and 198 deletions
--- a/.gitignore
+++ b/.gitignore
@ -1,2 +1,3 @@
 .DS_Store
-book
+book
+Changelog.md
--- a/src/first-try/sth-you-should-not-do.md
+++ b/src/first-try/sth-you-should-not-do.md
@ -16,7 +16,7 @@ Rust 是一门全新的语言，它会带给你前所未有的体验，提升你
 - 不要抱着试一试的心态去试一试，否则是浪费时间和消耗学习的激情，作为连续六年全世界最受喜欢的语言，Rust 不仅仅是值得试一试 :)
 - 深入学习一本好书或教程

-总之, Rust 入门难，但是在你一次次克服艰难险阻的同时，也一次次收获了与众不同的编程经验，最后历经九九八十一难，立地成大佬。 给自己一个机会，也给 Rust 一个机会 ：）
+总之，Rust 入门难，但是在你一次次克服艰难险阻的同时，也一次次收获了与众不同的编程经验，最后历经九九八十一难，立地成大佬。 给自己一个机会，也给 Rust 一个机会 ：）

 ## 深入学习一本好书

@ -44,7 +44,7 @@ CS（Computer Science：计算机科学）课程中我们会学习大量的常

 ## 仔细阅读编译错误

-在一些编程语言中，你可能习惯了编译器给出的错误只要看前面(或后面)几行就行，大部分是不怎么用到的信息，总之编译器总感觉笨笨的。
+在一些编程语言中，你可能习惯了编译器给出的错误只要看前面（或后面）几行就行，大部分是不怎么用到的信息，总之编译器总感觉笨笨的。

 但是 Rust 不是，它为我们提供了一个强大无比的编译器，而且会提示我们该如何修改代码以解决错误，简直就是一个优秀的老师！

--- a/src/logs/observe/about-observe.md
+++ b/src/logs/observe/about-observe.md
@ -38,7 +38,7 @@

 因为问题的跟踪和解决其实就是沿着数据的流向来的，我们只要在 trace 流动的过程中，在沿途把相关的 log 收集上来，然后再针对收到的各种 trace，根据其标签去统计相应的指标。

-这一样，是不是就成功地将三个模型关联在了一起？而且还不是强扭的瓜！
+这样，是不是就成功地将三个模型关联在了一起？而且还不是强扭的瓜！

 再回到之前假设的场景：当我们对某个 Metric 波动发生兴趣时，可以直接将造成此波动的 Trace 关联检索出来，然后查看这些 Trace 在各个微服务中的所有执行细节，最后发现是底层某个微服务在执行请求过程中发生了 Panic，这个错误不断向上传播导致了服务对外 SLA 下降。

--- a/src/logs/observe/intro.md
+++ b/src/logs/observe/intro.md
@ -4,7 +4,7 @@

 - 老板眼中的监控：业务大数据实时展示
 - 前端眼中的监控：手机 APP 收集上来的异常、崩溃、用户操作日志等
- 后端眼中的监控: 请求链路跟踪、一段时间内的请求错误率、QPS 过高、异常日志等
+- 后端眼中的监控：请求链路跟踪、一段时间内的请求错误率、QPS 过高、异常日志等

 正是因为这些复杂性，导致很多同学难以准确的说出监控到底是什么。

--- a/内容变更记录.md
+++ b/内容变更记录.md
@ -1,193 +0,0 @@
-# ChangeLog
-记录一些值得注意的变更。
-
-## 2022-04-23
-
- 发布 [Rust 周刊第 9 期](https://course.rs/rust-weekly.html)
-
-## 2022-04-15
-
- 调整数值类型章节的目录结构，并新增位运算，感谢 [liCells](https://github.com/liCells) 提交的 PR
-
-## 2022-04-12
-
- [优化字符串章节，增加字符串转义](https://course.rs/basic/compound-type/string-slice.html#字符串转义)
-
-## 2022-04-11
-
- 增加 [OnceCell](https://course.rs/advance/global-variable.html#标准库中的-oncecell), 感谢 [Rustln](https://github.com/rustln) 提交的 PR
-
-
-## 2022-04-08
-
- 新增章节: [日志 - tracing 包](https://course.rs/logs/tracing.html)
- 变量章节新增下划线的说明
-
-## 2022-04-08
-
- 新增章节: [Rust 1.60 发布解读](https://course.rs/appendix/rust-versions/1.60.html)
- 新增章节: [日志 - 门面库 log](https://course.rs/practice/logs/log.html)
-
-## 2022-04-07
-
- 新增章节: [小试牛刀 - 下载太慢了?](https://course.rs/first-try/slowly-downloading.html)
- 新增章节: [日志与监控 - 日志详解](https://course.rs/practice/logs/about-log.html)
- 新增章节: [日志与监控 - 使用 tracing 输出自定义日志](https://course.rs/practice/logs/tracing-logger.html)  
-
-## 2022-04-05
-
- 新增章节：[Cookbook - 字符编码](https://cookbook.rs/encoding/strings.html)
- 新增章节：[Cookbook - CSV处理](https://cookbook.rs/encoding/csv.html)
-
-## 2022-04-04 
-
- 新增章节: [Cookbook - 使用 rayon 并行处理数据](https://course.rs/cookbook/cocurrency/parallel.html)
- 新增章节： [Cookbook - 加密](https://course.rs/cookbook/cryptography/encryption.html)
- 新增章节： [Cookbook - 哈希](https://course.rs/cookbook/cryptography/hashing.html)
- 新增章节： [Cookbook - 位字段](https://course.rs/cookbook/datastructures/bitfield.html)
- 新增章节: [Cookbook - 数据库](https://course.rs/cookbook/database/sqlite.html)
- 新增章节: [Cookbook - 开发者工具](https://course.rs/cookbook/devtools/log.html)
-
-## 2022-04-03
-
- 新增章节：[Cookbook - 线程](http://course.rs/cookbook/cocurrency/threads.html)
-
-## 2022-04-01
-
- 新增章节: [Cookbook - 生成随机值](https://course.rs/cookbook/algos/randomness.html)
- 新增章节: [Cookbook - Vec排序](https://course.rs/cookbook/algos/sorting.html)
- 新增章节: [Cookbook - 命令行参数解析](https://course.rs/cookbook/cmd/parsing.html)
- 新增章节：[Cookbook - 终端输出格式化](https://course.rs/cookbook/cmd/ansi.html)
- 新增章节：[Cookbook - 压缩 tar 包](https://course.rs/cookbook/compression/tar.html)
-
-
-## 2022-03-29
-
- 新增章节: [栈上的链表](https://course.rs/too-many-lists/advanced-lists/stack-allocated.html)
- 重新修订章节： [&'static 与 T: 'static](https://course.rs/advance/lifetime/static.html)
-  
-## 2022-03-28
-
- 新增章节：[双单向链表](https://course.rs/too-many-lists/advanced-lists/double-singly.html)
- 优化样式：增加目录中的区域性标题、修改 GitHub 图标和说明，通过 js 增加访问者统计
- 新增创作感悟 
-
-## 2022-03-27
-
- 新增章节: [不错的unsafe队列 - 额外的操作](https://course.rs/too-many-lists/unsafe-queue/extra-junk.html)
- 新增章节： [不错的unsafe队列 - 最终代码](https://course.rs/too-many-lists/unsafe-queue/final-code.html)
-
-
-## 2022-03-25
-
- 将 gitalk 更换成 giscuz 评论系统，同时优化了样式展现和默认语言
-
-## 2022-03-24
-
- 新增章节: [不错的unsafe队列 - 数据布局2](https://course.rs/too-many-lists/unsafe-queue/layout2.html)
- 优化在线书籍样式：增加章节目录行间距、调整滚动条的宽度、优化无内容章节字体颜色等
-
-## 2022-03-22
-
- 新增章节: [不错的unsafe队列-测试栈借用](https://course.rs/too-many-lists/unsafe-queue/testing-stacked-borrow.html)
-  
-## 2022-03-18
-
- 新增章节内目录、评论系统，支持屏幕大小自适
- 新增章节： [不错的unsafe队列-栈借用](https://course.rs/too-many-lists/unsafe-queue/stacked-borrow.html)
- 新增章节: [不错的unsafe队列-基本操作](http://localhost:3000/too-many-lists/unsafe-queue/basics.html)
- 新增章节: [不错的unsafe队列-使用miri](http://localhost:3000/too-many-lists/unsafe-queue/miri.html)
-
-## 2022-03-17
-
- 将`原生指针`更名为`裸指针`
- 新增章节: [不错的unsafe队列-数据布局](https://course.rs/too-many-lists/unsafe-queue/layout.html)
- 新增章节: [deque-迭代器](https://course.rs/too-many-lists/deque/iterator.html)
- 新增章节: [deque-最终代码](https://course.rs/too-many-lists/deque/final-code.html)
-
-## 2022-03-16
-
- 新增章节: [deque-基本操作的对称镜像](https://course.rs/too-many-lists/deque/symmetric.html)
- 新增章节: [deque-Peek](https://course.rs/too-many-lists/deque/peek.html)
- 新增章节： [deque-数据布局和基本操作](https://course.rs/too-many-lists/deque/layout.html)
-
-## 2022-03-14
-
- 新增章节: [Rust 陷阱 - UTF-8 引发的性能隐患](https://course.rs/pitfalls/utf8-performance.html)
- 新增章节：[持久化链表 - 数据布局和基本操作](https://course.rs/too-many-lists/persistent-stack/layout.html)
- 新增章节：[持久化链表 - Drop、Arc 及完整代码](https://course.rs/too-many-lists/persistent-stack/drop-arc.html)
-  
-## 2022-03-13
-
- 新增章节: [还 OK 的单向链表 - IterMut](https://course.rs/too-many-lists/ok-stack/itermut.html)
- 新增章节: [还 OK 的单向链表 - IntoIter 和 Iter](https://course.rs/too-many-lists/iter.html)
- 优化[进一步深入特赠 - 关联类型](https://course.rs/basic/trait/advance-trait.html#关联类型)中的部分内容，感谢 AllenYu0018 的[提示](https://github.com/sunface/rust-course/discussions/392).
-
-## 2022-03-11
-
- 新增章节: [还 OK 的单向链表 - Peek 函数](https://course.rs/too-many-lists/ok-stack/peek.html)
- 在特征对象章节添加图表的[详细解释](https://course.rs/basic/trait/trait-object.html#特征对象的动态分发)，感谢 [@Rustln](https://github.com/Rustln) 的倾情贡献
- 新增章节: [不太优秀的单向链表 - 收尾工作及最终代码](https://course.rs/too-many-lists/bad-stack/final-code.html)
- 新增章节：[还 OK 的单向链表 - 类型优化](https://course.rs/too-many-lists/ok-stack/type-optimizing.html)
-
-## 2022-03-10
-
- 新增章节：[不太优秀的单向链表 - 数据布局](https://course.rs/too-many-lists/bad-stack/layout.html)
- 新增章节: [不太优秀的单向链表 - 基本操作](https://course.rs/too-many-lists/bad-stack/basic-operations.html)
-
-
-## 2022-03-09
-
- 在 [Deref 章节](https://course.rs/advance/smart-pointer/deref.html)中新增开篇引导示例，帮助读者更好的理解当前章节
- 为部分章节增加[课后练习题链接](https://github.com/sunface/rust-by-practice)
- 移除类型转换章节中一段错误的内容
-
-
-## 2022-03-08
-
- 新增章节: [我们到底需不需要链表](https://course.rs/too-many-lists/do-we-need-it)
-
-
-## 2022-03-07
-
- 新增章节: [Eq 和 PartialEq](https://course.rs/confonding/eq.html)
-
-## 2022-03-04
-
- 新增专题: [手把手带你实现链表](https://course.rs/linked-list/intro)
- 新增章节: [最佳实践 - 面试经验](https://course.rs/practice/interview.html)
- 为部分章节增加[课后练习题链接](https://github.com/sunface/rust-by-practice)
-
-
-## 2022-03-03
-
- 新增章节: [Cargo - 构建脚本示例](https://course.rs/cargo/reference/build-script/examples.html)
-
-## 2022-03-02
-
- 新增章节: [Cargo - 构建脚本](https://course.rs/cargo/reference/build-script/intro.html)
-
-## 2022-02-28
-
- 新增章节: [Cargo - 发布到crates.io](https://course.rs/cargo/reference/publishing-on-crates.io.html)
- 新增内容：[结构体 - #[derive(Debug)]](https://course.rs/basic/compound-type/struct.html#使用-derivedebug-来打印结构体的信息)
-  
-## 2022-02-27
-
- 增加如何生成[测试可执行文件](https://course.rs/test/write-tests.html#生成测试二进制文件)
- 屏蔽附录中的重点索引，未来集中放入到[快速查询入口中](https://course.rs/index-list.html)
-
-
-## 2022-02-26
-
- 对于过程宏为何要放在单独的包的原因进行了[说明](https://course.rs/advance/macro.html#用过程宏为属性标记生成代码)
-  
-## 2022-02-25
-
- 新增 1.59 [版本说明](https://course.rs/appendix/rust-versions/1.59.html)
- 在变量绑定章节新增[解构式赋值](https://course.rs/basic/variable.html#解构式赋值)
-  
-## 2022-02-24
-
- 进阶中的enum/整数类型转换、newtype章节被合并到**深入类型**目录中
- 将 newtype 中的 Sized/DST 内容拆分成单独的章节，并扩展了相应内容