rename titles; make descriptions clearer

Author: Rratic

README.md

@@ -1,7 +1,7 @@
 ## 关于
 ![](https://img.shields.io/badge/LICENSE-CC%20BY--NC--SA%204.0-lightgrey)
 
-欢迎阅读 Julia Roadmap！这是一个社区支持的计划，旨在帮助学习者更好地了解、掌握和精通 Julia 语言，并提供学习路径、资料整合、现有经验及练习。
+欢迎阅读 Julia 中文导航！这是一个社区支持的计划，旨在帮助学习者更好地了解、掌握和精通 Julia 语言，并提供学习路径、资料整合、现有经验及练习。
 
 更多内容见[主页](https://learn.juliacn.com/)。
 

docs/advanced/else.md

@@ -1,4 +1,4 @@
-# 其它
+# 更多 19 项内容
 ## 底层
 * [变量引用机制](varref.md)
 * [引用](ref.md)

docs/basic/basicio.md

@@ -1,4 +1,4 @@
-# 基础I/O
+# 字符串与基础 I/O
 ## 字符串基础
 你将[在之后读到](string.md)关于字符串更详细的信息。
 

docs/basic/bool.md

@@ -1,8 +1,8 @@
-# 布尔
+# 布尔类型与逻辑
 ## 布尔逻辑
 [在此阅读](../knowledge/bool_logic.md)关于布尔逻辑的详细内容。
 
-`Bool` 是 Julia 中的布尔类型名，其值只能为 `true` 与 `false` 之一。
+`Bool` 是 Julia 中的布尔类型名，其值只能为真 `true` 与假 `false` 之一。
 
 ## 运算
 | 表达式 | 名称 |

docs/basic/float.md

@@ -1,4 +1,4 @@
-# 浮点数
+# 浮点数与实数运算
 浮点数是 IEEE 754 标准规定的，广泛用于数学运算的数据类型，用来表示可用于通常计算的实数。
 以下是 Julia 预定义的浮点数类型
 

docs/basic/hello.md

@@ -1,11 +1,12 @@
 # Hello World
 欢迎来到正式内容的第一章！
 
-如果觉得本文档（或本教程“语言基础”部分）废话太多，与已有知识高度重合，可以选择[其它文档](../meta/resources.md#其它文档)中标有“快速学习”的项目阅读。
+如果觉得本文档（或本教程“语言基础”部分）面向新手的内容过多，可以选择[文档教程](../meta/resources.md#文档教程)中标有“快速学习”的项目快速划过 Julia 语法。
 
 ## 注释
-注释通常是一种解释性文本（即给人读的），它们不会被解释器运行。
-你可以打开 [REPL](setup_environment.md#运行%20REPL)，然后尝试以下操作：
+注释是一种解释性文本，即给开发者与使用者阅读，或用于生成文档被开发者与使用者阅读的文本。注释内容不会被解释器运行，不会产生代码效果。
+
+你可以打开 [REPL](setup_environment.md#运行%20REPL)，然后尝试以下操作（使用键盘在 `julia> ` 提示符后输入）：
 ```julia-repl
 julia> # 以 '#' 开头的是单行注释
 
@@ -18,28 +19,35 @@ julia> # 如果你发现除了新的一行以外什么都没显示，说明您
 
 ```
 
+这个例子中，注释前面除了 `#` 号还有一个空格。这纯粹是为了美观，去掉这个空格，仍然是注释。
+
 !!! tips
-	如果你有一段代码暂时不用，但觉得以后可能用到/扔了可惜，可以把它用多行注释注释掉
+	如果你有一段代码暂时不用，但觉得以后可能用到/扔了可惜，可以在它前后加上一对 `#=`, `=#` 变成多行注释，或者在每行前面加上 `# ` 变成单行注释，这样可以随时找回。
 
 ## 输出
-为了让你得到系统性的概念，之后的几章理论内容偏多。因此，你有必要先了解点东西：
+现在可以引入经典的 Hello World 程序：
 ```julia-repl
 julia> print("Hello, world!")
 Hello, world!
 ```
 
-使用形如 `print("")`。在一对双引号中放置你想要输出的内容，它就会将这段内容显示在屏幕上。
-如果你得到了错误的结果，可能是因为：
-* 没有双引号或使用了中文输入法中的中文引号等，括号同理
-* `print` 拼错
-* 你暂时还不需要知道如何输出 `"` 本身或其它奇奇怪怪的东西
-* 请仔细检查，若挣扎没有结果，可以将相关信息发布在下方聊天区或向其他人求助
+使用形如 `print("text")` 的代码输出你想要输出的文本。在一对双引号中放置想要输出的内容，运行结果是将这段内容显示在屏幕上。
+
+如果出现一串以红色 `ERROR:` 开头的文字，说明 REPL 向你报告了错误。可能是因为：
+* 漏掉双引号 `""` 或使用了中文输入法中的中文引号 `“”` 等，括号也是同理
+* `print` 的拼写不正确
+
+请仔细检查，如果无法检查出问题，可向其他人求助。
 
 如果想在输出后换行，将 `print` 改为 `println` 即可。
+```julia-repl
+julia> println("Hello, world!")
+Hello, world!
+
+```
 
-是的，Julia 的自带 REPL 中没有 Python IDLE 那样的高级文件功能。
-因此，如果想一次运行多行代码，你可以
-* 使用高级编辑器
+Julia 的自带 REPL 中没有高级文件功能。因此，如果想要一次运行多行代码，你可以：
+* [使用高级编辑器](../meta/setup_workspace.md)
 * [运行文件里的代码](setup_environment.md#运行文件)
 * 使用 `begin ... end` 包裹它们
  	```julia-repl
@@ -52,5 +60,11 @@ Hello, world!
 	```
 
 ## 练习
-- 已知某行代码以 `#` 开头，试找到在该行中写会被运行的代码的方法。
-- 使用代码输出「这句话」
+- 如果你只能输入一行代码，且必须以 `#` 开头，试找到输出 `Hello, world!` 的方法
+- 试输出：
+	```plain
+	KING
+	IDEA
+	NEST
+	GATE
+	```

docs/basic/int.md

@@ -1,11 +1,11 @@
-# 整数
+# 整数与整数运算
 **整数**是用于运算的最基本的数据类型之一。整数被广泛使用，例如它可以用于：
 * 纯粹的整数运算
 * 控制循环次数
 * 控制索引位置
 
 ## 整数类型
-Julia 中的整数类型包含了所有常见的[位数](../knowledge/bits.md#位)。以下是常见的整数类型。
+Julia 中的整数类型包含了所有常见的[位数](../knowledge/bits.md#位)。以下是常见的整数类型：
 | 类型 | 带符号 | 位数 |
 | :-: | :-: | :-: |
 | `Int8` | Y | 8 |
@@ -20,7 +20,7 @@ Julia 中的整数类型包含了所有常见的[位数](../knowledge/bits.md#
 | `UInt128` | N | 128 |
 
 整数类型的命名是有规律的。
-* `int` 是 `integer` 的缩写。
+* `int` 是整数的英文 `integer` 的缩写。
 * `u` 是**无符号**（unsigned）的缩写。`U` 开头的表示无符号类型，即该类型的值保持在**非负**整数。
 * 末尾的数字表示类型的位数。
 
@@ -43,7 +43,7 @@ julia> typeof(1234)
 Int64
 ```
 
-无符号整数以十六进制、二进制或八进制表示（后 2 个基本没人用），会根据数据大小自动改变类型位数
+无符号整数可以以十六进制表示（甚至可以以二进制与八进制表示），会根据数据大小自动选取类型位数：
 ```julia-repl
 julia> typeof(0xbeef)
 UInt16
@@ -55,9 +55,9 @@ julia> typeof(0x0)
 UInt8
 ```
 
-如果你没有得到你期望的结果，可以强制类型转化
+如果你没有得到你期望的类型，可以强制类型转化：
 ```julia-repl
-julia> x = UInt8(100)
+julia> x = UInt8(100) # 或者 `x :: UInt8 = 100`
 0x64
 
 julia> typeof(x)
@@ -70,9 +70,7 @@ UInt8
 预定义了 `Int` 与 `UInt` 类型，位数对应系统位数（通常是 64）
 
 !!! note
-	如果你熟悉 C 语言，那么 Julia 提供了以 C 中 `int` 等类型命名的类型，它们是以上整数类型的别名。
-	`Cint`，`Cintmax_t`，`Clong`，`Clonglong`，`Cshort`，`Csize_t`，`Cssize_t`，`Cptrdiff_t`，
-	`Cuint`，`Cuintmax_t`，`Culong`，`Culonglong`，`Cushort`。
+	如果你熟悉 C 语言，可以找到 Julia 提供的以 C 中类型命名的类型，它们实际上是以上整数类型的别名。这包括：`Cint`, `Cintmax_t`, `Clong`, `Clonglong`, `Cshort`, `Csize_t`, `Cssize_t`，`Cptrdiff_t`, `Cuint`, `Cuintmax_t`, `Culong`, `Culonglong`, `Cushort`.
 
 ## 高精度整数
 高精度整数的类型名为 `BigInt`，它们可以使用 `big(值)` 定义。这可以表示相当大的整数。
@@ -112,9 +110,9 @@ julia> 2(x-1)
 14
 ```
 
-在样例 `2(x-1)` 中，`*` 号被省略了，这是 Julia 用以更符合数学书写习惯的设计 [^3]
+在样例 `2(x-1)` 中，`*` 号被省略了，这是 Julia 用以更符合数学书写习惯采取的设计。[^3]
 
-可以在**二元**运算符后加 `=`，变成复合赋值操作符，会对前者进行改变
+可以在**二元**运算符后加 `=`，变成复合赋值操作符，会对前者进行改变：
 ```julia-repl
 julia> a = 1
 1
@@ -135,7 +133,7 @@ julia> a, b
 (3, 2)
 ```
 
-你可能会发现，一些变量在操作后类型发生了改变
+你可能会发现，一些变量在操作后类型发生了改变：
 ```julia-repl
 julia> v = Int16(0)
 0
@@ -158,8 +156,8 @@ Int64
 | `x & y` | 按位与 |  |
 | `x | y` | 按位或 |  |
 | `x ⊻ y` | 按位异或 | 也可以使用 `xor(x, y)`，或用 `\xor` + Tab 打出该符号 |
-| `x ⊼ y` | 按位非与 | 同上，对应 `nand` |
-| `x ⊽ y` | 按位非或 | 同上，对应 `nor` |
+| `x ⊼ y` | 按位非与 | 同上，对应的是 `nand` |
+| `x ⊽ y` | 按位非或 | 同上，对应的是 `nor` |
 | `x >>> y` | 逻辑右移 |  |
 | `x >> y` | 算术右移 |  |
 | `x << y` | 逻辑/算术左移 |  |
@@ -202,7 +200,7 @@ julia> left <= x <= right # 你通常会这样用它
 ```
 
 ## 练习
-- 试计算 $5^{40}$
+- 使用 Julia 计算 $5^{40}$ 的结果
 
 [^1]: 更多内容参见 <https://docs.juliacn.com/latest/manual/mathematical-operations/>
 [^3]: 但是不会存在诸如把 `xy` 解析成 `x * y` 的情况

docs/basic/little_types.md

@@ -1,4 +1,4 @@
-# 实用类型
+# 间章：一些实用类型
 ## 无
 类型 `Nothing` 具有的唯一值是 `nothing`。
 它对应 `C` 中的 `void`，也广泛用于普通变量的初始化、保留值等。

docs/basic/range.md

@@ -1,4 +1,4 @@
-# 范围
+# 范围类型
 ## UnitRange
 使用语法糖 `start:stop` 或调用 `UnitRange(start, stop)`，可以生成一个从 `start` 到 `stop`，每步增加 1 的范围。
 ```julia-repl

docs/basic/setup_environment.md

@@ -165,7 +165,7 @@ PS C:\Users\username>
 
 更多功能请参考[命令行选项](https://docs.juliacn.com/latest/manual/command-line-options/#command-line-options)
 
-如果你想在打开 REPL 后运行指定文件中的代码，可以使用 `include("文件路径")`，更多在[此](../basic/misc.md#加载代码)阅读。
+如果你想在打开 REPL 后运行指定文件中的代码，可以使用 `include("文件路径")` 加载它。
 
 ## 其它配置
 * 关于包服务器镜像的配置，参阅[包的简介 - 包服务器](../workflow/introduction.md#包服务器)。