From f4f0bd973e61fbfbba00bd9420bc94844a13bdb5 Mon Sep 17 00:00:00 2001 From: sunface Date: Mon, 28 Feb 2022 15:57:36 +0800 Subject: [PATCH] udpate readme.md --- Readme.md | 9 ++++-- en/src/why-exercise.md | 54 ++++++++++++++------------------- zh-CN/Readme.md | 41 ------------------------- zh-CN/src/why-exercise.md | 64 ++++++++++++++++++--------------------- 4 files changed, 58 insertions(+), 110 deletions(-) delete mode 100644 zh-CN/Readme.md diff --git a/Readme.md b/Readme.md index de7988a..c30154b 100644 --- a/Readme.md +++ b/Readme.md @@ -9,11 +9,11 @@ Practice Rust with easy to hard examples, exercises and small projects. ## Why another? -[Rustlings](https://github.com/rust-lang/rustlings) and [Rust By Example](https://github.com/rust-lang/rust-by-example) are absolutely very nice, but Rust By Practice provides a little more: +[Rustlings](https://github.com/rust-lang/rustlings) and [Rust By Example](https://github.com/rust-lang/rust-by-example) are absolutely very nice, but we provides a little more: 1. We have more exercises of which the difficulty is from easy to hard -2. Covers more topics in Rust, such as **async/await, threads, sync primitives and stand libraries** etc +2. Covers more topics in Rust, such as **async/await, threads, sync primitives, optimizing and stand libraries** etc 3. Learning from small projects, for pratice @@ -23,7 +23,7 @@ Practice Rust with easy to hard examples, exercises and small projects. - You can edit and run the exercises online -- **The goal is to make each exercise comipile with NO ERRORS!** +- **The goal is to make each exercise comipile with NO ERRORS and Panics !** - Difficulty level: easy: 🌟 medium: 🌟🌟 hard: 🌟🌟🌟 hell: 🌟🌟🌟🌟 @@ -33,3 +33,6 @@ Practice Rust with easy to hard examples, exercises and small projects. All kinds of contributions are welcomed, such as exercise proposing, typo and bug fixing. +## Buy me a ... 🌟? + +Fo us, a github star will be better than a cup coffee, and it only costs you 0 cents :) \ No newline at end of file diff --git a/en/src/why-exercise.md b/en/src/why-exercise.md index 0bbe93e..c30154b 100644 --- a/en/src/why-exercise.md +++ b/en/src/why-exercise.md @@ -1,48 +1,38 @@ # Rust By Practice -> 中文版[传送门](https://zh.practice.rs) +Practice Rust with easy to hard examples, exercises and small projects. -- Online Reading: [https://practice.rs](https://practice.rs) +## Read it online -Greetings and welcome here， if you have the following problems: +- [English](https://practice.rs) +- [Chinsese](https://zh.practice.rs) + +## Why another? -- You have learned basics of Rust, and want to learn more, e.g do some exercises, but found easy ones -- Practice Rust toolchains, std, ascyn/.await and more -- Have no idea of what to do next, maybe you tried writing a demo /project, but... not that good or even worse: failed +[Rustlings](https://github.com/rust-lang/rustlings) and [Rust By Example](https://github.com/rust-lang/rust-by-example) are absolutely very nice, but we provides a little more: -Maybe you have come to the right place. Here are lots of easy to hard exercises and practices to improve your Rust skills which cover almost every topic in Rust. +1. We have more exercises of which the difficulty is from easy to hard -In a word, this book will try to help you filling the gap between easy-to-learn and hard-to-use. +2. Covers more topics in Rust, such as **async/await, threads, sync primitives, optimizing and stand libraries** etc + +3. Learning from small projects, for pratice + +4. Both English and Chinese are supported ## How to use -- You can edit exercises online and also run it online -- **Your only goal is make every exercise comipile with NO ERRORS!** -- difficulty level: easy: 🌟 medium: 🌟🌟 hard: 🌟🌟🌟 hell: 🌟🌟🌟🌟 + +- You can edit and run the exercises online + +- **The goal is to make each exercise comipile with NO ERRORS and Panics !** + +- Difficulty level: easy: 🌟 medium: 🌟🌟 hard: 🌟🌟🌟 hell: 🌟🌟🌟🌟 ## Contributing -We welcome all kinds of contributors. -Every exercise you have contributed will be annotated with your github name and personal link, it's time to show yourself to the world! - -## Learning Rust -If you are a first-time Rust learner, here are some high quality learning resources : -- [The Book](https://doc.rust-lang.org/book/index.html) for English speakers -- [Rust语言圣经(The Course)](https://course.rs) for Chinese speakers, it covers nearly all the topics in Rust - - -## difference to rustlings -[Rustlings](https://github.com/rust-lang/rustlings) only contains small and easy exercises for junior rust devs. There is a big gap between learning Rust and using it in your projects. - -Another limit for rustlings is that you have to download rustlings to local machine and compile it first before starting to learn. - -## difference to rust by example -[Rust By Example](https://doc.rust-lang.org/stable/rust-by-example/) is an excellent online book for learning Rust，`practice.rs` has some small advantages in : - -- more topics and exercises，specially for the hard part of Rust，e.g string, lifetime, smart pointers, threads and async/.await etc -- difficulty from easy to hard，it will minimize the gap between learning and using in projects -- up-to-date, e.g features which added in Rust 1.59 also have the corresponding exercises in `practice.rs` -- real practices +All kinds of contributions are welcomed, such as exercise proposing, typo and bug fixing. +## Buy me a ... 🌟? +Fo us, a github star will be better than a cup coffee, and it only costs you 0 cents :) \ No newline at end of file diff --git a/zh-CN/Readme.md b/zh-CN/Readme.md deleted file mode 100644 index 278043b..0000000 --- a/zh-CN/Readme.md +++ /dev/null @@ -1,41 +0,0 @@ -# Rust By Practice -- English: [https://practice.rs](https://practice.rs) -- 简体中文: [https://zh.practice.rs](https://zh.practice.rs) - -欢迎大家来到 `practice.rs`，在来到这里之前不知道你有没有碰到过以下问题: - -- 学完知识，想要针对性的练习，但是只能找到一些不痛不痒的习题 -- 一些 Rust 工具、标准库等相关的习题更是一个都找不到 -- 做完了习题还是一片茫然，不知道下一步该做什么，上手写项目吧，发现几乎无处下手 - -如果你曾经和我有一样的问题，那来到这里就对了：**在这里你能找到大量从简单到困难的 Rust 练习题，不仅能针对性巩固你所学过的知识，解决 Rust 语言难以上手应用的问题**。 - -## 关于练习题的说明 -- 一切都在线化： 阅读、编辑和测试代码，当然还包括错误提示 -- 每一道练习题都只有一个目的：那就是让编译通过，但是你需要注意相应的提示，例如删除所有代码也可以让练习通过 -- 难度等级: 简单: 🌟 中等: 🌟🌟 困难: 🌟🌟🌟 地狱: 🌟🌟🌟🌟 - -## 欢迎你，贡献者 -本项目欢迎一切贡献者，特别是怀揣题库的兄弟，你所贡献的每一道题都会注明你的昵称和个人链接，是时候让全世界看看咱的风采了。 - -## 学习 Rust 语言 -我们强烈推荐在开始做练习之前，先看看 [<>]((https://course.rs)) 这本书，它覆盖了从入门到精通所需的全部知识，相信我，里面绝对有你所需要的 Rust 知识。 - -(悄咪咪的告诉咱中国用户， `practice.rs` 章节目录和 <> 完全相同，大家猜猜为什么) - - - - -## 对比 rustlings -[Rustlings](https://github.com/rust-lang/rustlings) 只包含了一些小型的、简单的练习题，说实话并不能帮你熟悉学到的 Rust 知识，更别提帮你打通从学习到实践的道路了。 - -另一个问题就是 rustlings 需要先下载到本地，然后编译运行，无法在线使用。 - -## 对比 Rust By Example -[Rust By Example](https://doc.rust-lang.org/stable/rust-by-example/) 是相当不错的在线练习题，相比之前，`practice.rs` 拥有以下优势 : - -- 内容覆盖面更广，且练习题更多、针对性更强，充分满足大家做题的快乐 -- 难度从简单到困难都有，且更贴合实际 -- 跟随 Rust 版本实时更新, -- `course.rs` 和 `practice.rs` 看域名就知道，它非常有信心才敢使用这两个针对性如此之强的域名，而信心来源于**高质量** -- 实践应用 \ No newline at end of file diff --git a/zh-CN/src/why-exercise.md b/zh-CN/src/why-exercise.md index af7927a..adda035 100644 --- a/zh-CN/src/why-exercise.md +++ b/zh-CN/src/why-exercise.md @@ -1,48 +1,44 @@ # Rust By Practice -> 英文版 [传送门](https://practice.rs) - -欢迎大家来到 `practice.rs`，在来到这里之前不知道你有没有碰到过以下问题: - -- 学完知识，想要针对性的练习，但是只能找到一些不痛不痒的习题 -- 一些 Rust 工具、标准库等相关的习题更是一个都找不到 -- 做完了习题还是一片茫然，不知道下一步该做什么，上手写项目吧，发现几乎无处下手 - -如果你曾经和我有一样的问题，那来到这里就对了：**在这里你能找到大量从简单到困难的 Rust 练习题，不仅能针对性巩固你所学过的知识，解决 Rust 语言难以上手应用的问题**。 +通过简单到困难的示例、练习及小型项目来练习和实践 Rust。 ## 在线阅读 -本书同时提供了中文和英文版本: -- English: [https://practice.rs](https://exercise.rs) -- 简体中文: [https://zh.practice.rs](https://zh.exercise.rs) -## 关于练习题的说明 -- 一切都在线化： 阅读、编辑和测试代码，当然还包括错误提示 -- 每一道练习题都只有一个目的：那就是让编译通过，但是你需要注意相应的提示，例如删除所有代码也可以让练习通过 -- 难度等级: 简单: 🌟 中等: 🌟🌟 困难: 🌟🌟🌟 地狱: 🌟🌟🌟🌟 +- [英文地址](https://practice.rs) +- [中文地址](https://zh.practice.rs) + +## 为何又一个练习? -## 欢迎你，贡献者 -本项目欢迎一切贡献者，特别是怀揣题库的兄弟，你所贡献的每一道题都会注明你的昵称和个人链接，是时候让全世界看看咱的风采了。 +[Rustlings](https://github.com/rust-lang/rustlings) 和 [Rust By Example](https://github.com/rust-lang/rust-by-example) 都是非常好的练习方式，但是我们还提供了一些独家秘笈: -## 学习 Rust 语言 -我们强烈推荐在开始做练习之前，先看看 [<>]((https://course.rs)) 这本书，它覆盖了从入门到精通所需的全部知识，相信我，里面绝对有你所需要的 Rust 知识。 +1. 更多的练习题，难度从简单到困难 -(悄咪咪的告诉咱中国用户， `practice.rs` 章节目录和 <> 完全相同，大家猜猜为什么) +2. 覆盖面更广，除了 Rust 语言本身外，还包括了**async异步编程, 多线程, 并发原语, 性能优化和标准库等内容s** + +3. 通过一些小型时间项目来实践 Rust + +4. 支持英语和中文 + +## 如何使用 + +- 大家可以在线编辑和运行所有练习 + +- **唯一的目标就是让每一道题都编译通过，没有错误也没有 panic !** + +- 难度等级: 简单: 🌟 中等: 🌟🌟 困难: 🌟🌟🌟 地狱: 🌟🌟🌟🌟 + + +## 社区贡献 + +我们欢迎所有类型的社区贡献，包括新的练习题、bug和文字修正等。 + + +## Buy me a ... 🌟? + +对我们来说，来自读者大大的肯定比什么都重要，因此一个 [Github star](https://github.com/sunface/rust-by-practice) 要比一杯咖啡更让我们开心，而且现在它在跳楼打折，无需 998 ， 仅需 0 元钱 :) -## 对比 rustlings -[Rustlings](https://github.com/rust-lang/rustlings) 只包含了一些小型的、简单的练习题，说实话并不能帮你熟悉学到的 Rust 知识，更别提帮你打通从学习到实践的道路了。 - -另一个问题就是 rustlings 需要先下载到本地，然后编译运行，无法在线使用。 - -## 对比 Rust By Example -[Rust By Example](https://doc.rust-lang.org/stable/rust-by-example/) 是相当不错的在线练习题，相比之前，`practice.rs` 拥有以下优势 : - -- 内容覆盖面更广，且练习题更多、针对性更强，充分满足大家做题的快乐 -- 难度从简单到困难都有，且更贴合实际 -- 跟随 Rust 版本实时更新, -- `course.rs` 和 `practice.rs` 看域名就知道，它非常有信心才敢使用这两个针对性如此之强的域名，而信心来源于**高质量** -- 应用实践