diff --git a/.gitignore b/.gitignore index 35789499..9e0145c2 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,3 @@ .DS_Store -book \ No newline at end of file +book +Changelog.md diff --git a/src/first-try/sth-you-should-not-do.md b/src/first-try/sth-you-should-not-do.md index 5d0d936e..23fbfd8e 100644 --- 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 不是，它为我们提供了一个强大无比的编译器，而且会提示我们该如何修改代码以解决错误，简直就是一个优秀的老师！ diff --git a/src/logs/observe/about-observe.md b/src/logs/observe/about-observe.md index 5401e805..99b8d847 100644 --- 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 下降。 diff --git a/src/logs/observe/intro.md b/src/logs/observe/intro.md index de923357..9ca8de90 100644 --- a/src/logs/observe/intro.md +++ b/src/logs/observe/intro.md @@ -4,7 +4,7 @@ - 老板眼中的监控：业务大数据实时展示 - 前端眼中的监控：手机 APP 收集上来的异常、崩溃、用户操作日志等 -- 后端眼中的监控: 请求链路跟踪、一段时间内的请求错误率、QPS 过高、异常日志等 +- 后端眼中的监控：请求链路跟踪、一段时间内的请求错误率、QPS 过高、异常日志等 正是因为这些复杂性，导致很多同学难以准确的说出监控到底是什么。 diff --git a/内容变更记录.md b/内容变更记录.md deleted file mode 100644 index d995bc4f..00000000 --- a/内容变更记录.md +++ /dev/null @@ -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 内容拆分成单独的章节，并扩展了相应内容