1 files changed, 56 insertions, 25 deletions

diff --git a/docs/zh-cn/reference_glossary.md b/docs/zh-cn/reference_glossary.md
index 06d363250..e1dfccddd 100644
--- a/docs/zh-cn/reference_glossary.md
+++ b/docs/zh-cn/reference_glossary.md
@@ -1,5 +1,10 @@
 # QMK术语表
 
+<!---
+  original document: 0.15.12:docs/reference_glossary.md
+  git diff 0.15.12 HEAD -- docs/reference_glossary.md | cat
+-->
+
 ## ARM
 多家公司生产的32位单片机系列，例如Atmel, Cypress, Kinetis, NXP, ST, 和 TI等公司。
 
@@ -7,16 +12,16 @@
 [Atmel](https://www.microchip.com/)公司的单片机系列。 AVR是TMK的初始支持平台。
 
 ## AZERTY
-Français (法国)标准键盘布局。用键盘的前六个字母命名。
+Français （法语）标准键盘布局。用键盘的前六个字母命名。
 
 ## Backlight(背光)
-键盘上照明的通称。背光通常是一组LED灯，通过键帽或者按轴发光，但也不总是这样。
+键盘上照明的通称。背光通常是一组LED灯，穿过键帽或者轴体发光，但也不总是这样。
 
 ## Bluetooth(蓝牙)
-一种短距离点对点无线协议。许多多无线键盘使用此协议。
+一种短距离点对点无线传输协议。许多无线键盘使用此协议。
 
 ## Bootloader(引导加载程序)
-一种写到你单片机的保护区的特殊的程序，该程序可以使单片机升级自己的固件，通常是通过USB来升级。
+一种写到你单片机保护区的特殊程序，该程序可以使单片机升级自己的固件，通常是通过USB来升级。
 
 ## Bootmagic(热改键)
 允许各种键盘行为动态变化的功能，如交换或禁用常用键。
@@ -36,12 +41,12 @@ Français (法国)标准键盘布局。用键盘的前六个字母命名。
 ## Dynamic Macro(动态宏)
 一种记录在键盘上的宏，当键盘拔出或计算机重新启动时，宏将丢失。
 
-* [动态宏文档](feature_dynamic_macros.md)
+* [动态宏文档](zh-cn/feature_dynamic_macros.md)
 
 ## Eclipse
 是一种受C语言开发者追捧的集成开发环境(IDE)。
 
-* [Eclipse安装说明](eclipse.md)
+* [Eclipse安装说明](zh-cn/other_eclipse.md)
 
 ## Firmware(固件)
 用来控制单片机的软件。
@@ -52,14 +57,14 @@ Français (法国)标准键盘布局。用键盘的前六个字母命名。
 ## GitHub
 负责大多数QMK项目的网站。它是Git、问题跟踪和其他帮助我们运行qmk的功能的集成平台。
 
-## ISP(在系统编程)
-在系统编程(In-system programming), 使用外部硬件和JTAG管脚对AVR芯片进行编程的一种方法。
+## ISP(在������统编程)
+在������统编程(In-system programming), 使用外部硬件和JTAG管脚对AVR芯片进行编程的一种方法。
 
 ## hid_listen
 从键盘接收调试消息的接口。 您可以使用[QMK Flasher](https://github.com/qmk/qmk_flasher)或[PJRC's hid_listen](https://www.pjrc.com/teensy/hid_listen.html)查看这些消息
 
 ## Keycode(键码)
-表示特定键的2字节数据。`0x00`-`0xFF`用于[基本键码](keycodes_basic.md)而`0x100`-`0xFFFF`用于[量子键码](quantum_keycodes.md).
+表示特定键的2字节数据。`0x00`-`0xFF`用于[基本键码](zh-cn/keycodes_basic.md)而`0x100`-`0xFFFF`用于[量子键码](zh-cn/quantum_keycodes.md).
 
 ## Key Down
 一个键按下尚未抬起时触发的事件。
@@ -71,12 +76,12 @@ Français (法国)标准键盘布局。用键盘的前六个字母命名。
 映射到物理键盘布局的一组键码，在按键和按键释放时进行处理。有时翻译为布局，意为软件上表示的布局，即映射。
 
 ## Layer(层)
-为了让一个键实现多个功能的抽象结构。最高活���层有限。
+为了让一个键实现多个功能的抽象结构。�����层������上限。
 
 ## Leader Key(前导键、设置菜单键)
 本功能允许您点击前导键，然后按顺序按1-3个键子来激活按键或其他量子功能。
 
-* [前导键文档](feature_leader_key.md)
+* [前导键文档](zh-cn/feature_leader_key.md)
 
 ## LED
 发光二极管，键盘上最常用的指示灯装置。
@@ -90,18 +95,18 @@ Français (法国)标准键盘布局。用键盘的前六个字母命名。
 ## Macro(宏)
 本功能可以在敲击单个键后发送多个按键事件(hid报告)。
 
-* [宏文档](feature_macros.md)
+* [宏文档](zh-cn/feature_macros.md)
 
 ## MCU(单片机、微控制单元)
 微控制单元，键盘的处理器。
 
-## Modifier(修改键、修������、功能键)
+## Modifier(修������、修改键、功能键)
 按住该键将会改变其他键的功能，修饰键包括 Ctrl, Alt, 和 Shift。
 
 ## Mousekeys(鼠标键)
 本功能在您敲击键盘时会控制鼠标光标。
 
-* [鼠标键文档](feature_mouse_keys.md)
+* [鼠标键文档](zh-cn/feature_mouse_keys.md)
 
 ## N-Key Rollover (NKRO、全键无冲)
 一种术语，适用于能够同时报告任意数量按键的键盘。
@@ -128,17 +133,17 @@ Français (法国)标准键盘布局。用键盘的前六个字母命名。
 HID报告中的一个1字节的数字，表示一个键子。这些数字在下列文档中[HID Usage Tables](https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf)该文档发布于[USB-IF](https://www.usb.org/)。
 
 ## Space Cadet键盘的shift键
-一种特使的shift设置，能让你通过敲击左或右shift一次或多次键入不同的括号。
+一种特殊的shift设置，能让你通过敲击左或右shift一次或多次键入不同的括号。
 
-* [Space Cadet键盘文档](feature_space_cadet.md)
+* [Space Cadet键盘文档](zh-cn/feature_space_cadet.md)
 
 ## Tap(敲击、单击)
-按下并释���一个键。在某些情况下您需要区分键按下和键抬起，但是单击把两个事件都包括了。
+按下并���起一个键。在某些情况下您需要区分键按下和键抬起，但是单击把两个事件都包括了。
 
 ## Tap Dance(多击键)
 本功能允许向同一个键子分配多个键码，并根据按键次数区分。
 
-* [多击键文档](feature_tap_dance.md)
+* [多击键文档](zh-cn/feature_tap_dance.md)
 
 ## Teensy
 一种低成本AVR开发板<!--译者吐槽：我怎么感觉成本不低。好吧，我穷。 -->，通常用于手工连线键盘。这个teensy是有点小贵但是halfkay bootloader会让它刷写十分简单，所以也很常用。
@@ -147,21 +152,47 @@ HID报告中的一个1字节的数字，表示一个键子。这些数字在下�
 用于照亮电路板底面的LED的总称。这些LED通常从印刷电路板的底部向键盘所在的表面发光。
 
 ## Unicode
-在较大的计算机世界中，Unicode是一组编码方案，用于表示任何语言中的字符。 与qmk相关的是，它意味着使用各种操作系统方案来发送Unicode代码点，而不是扫描码。
+在广阔的计算机世界中，Unicode是一组编码方案，用于表示任何语言中的字符。 与qmk相关的是，它意味着使用各种操作系统方案来发送Unicode码点，而不是扫描码。
 
-* [Unicode文档](feature_unicode.md)
+* [Unicode文档](zh-cn/feature_unicode.md)
 
 ## Unit Testing(单元测试)
-针对qmk的自动运行测试框架。单元测试帮助我们确信我们的更改不会破坏任何东西。
+针对qmk的自动测试框架。单元测试帮助我们确信我们的更改不会破坏任何东西。
 
-* [单元测试文档](unit_testing.md)
+* [单元测试文档](zh-cn/unit_testing.md)
 
 ## USB
 通用串行总线，键盘最常见的有线接口。
 
-## USB 主机 (或简易主机)
-USB��������你的电脑，或者你的键盘所插的任何设备。
+## USB 主机 (简称主机)
+USB���������是你的电脑，或者你的键盘所插的任何设备。
 
 # 并没有找到你想找到的术语?
 
-[建立一个issue](https://github.com/qmk/qmk_firmware/issues) ，想好你的问题，或许你所问的术语就会添加到这里。创建一个PR帮我们添加需要添加的术语当然坠吼了:)
+[新建一个issue](https://github.com/qmk/qmk_firmware/issues) ，想好你的问题，或许你所问的术语就会添加到这里。创建一个PR帮我们添加需要添加的术语当然坠吼了:)
+
+## 中文翻译术语特别说明（terms of Chinese translation）:id=terms-of-zh-cn-translate
+!>如果你对QMK文档翻译中的细节不关心，请跳过该节
+
+由于语言及文化差异，QMK英文文档中的部分内容，很难在**保持原句结构**的情况下，完美地翻译为中文，而保持翻译前后的语句结构一致对于开源代码的文档翻译来讲十分重要，这样才能确保不同的文档贡献者不会*夹带私货*，防止不同的翻译风格、不同的翻译水准、不同的理解与润色最终产生糟糕的混合。
+因此，这里会对一些词组的的翻译进行规范化，并希望阅读者及后续文档翻译维护者，维持这种统一的范式。
+
+### keyboard（键盘）及keymap（键映射）
+QMK文档中使用最多的两个术语是keyboard及keymap
+* 键盘：在中文语境下，我们提及键盘，基本是在指物理键盘，而在QMK文档中到处可见的“键盘”一词，多对应的是代码中 `keyboards\` 目录下的键盘定义，其更接近于我们讲的“配列”的概念，主要描述了键盘的大体结构，物理键数量及排列。
+* 键映射：keymap的作用是定义物理键盘到实际输出键值(keycode)的映射关系，也是QMK最重要、涉及最多的概念。QMK很多功能就是为了能够在不改变键盘物理排列/电路组成/芯片程序的情况下，动态地改变物理按键输出的键值。如，通过层切换，将原先的wasd键，切换到可以上下左右的模式，或是一键切换CapsLock和Control，实现这些功能的核心工作就是一套动态的keymap，即键映射逻辑。这里不使用“布局”一词作为keymap的翻译，是因为该词过于宽泛。键映射即便是不好听，至少解释了意思且语境中不容易误解。
+
+### mod-tap
+倾向于不翻译，直接使用原词。因为找不到合适的译法
+
+### dead key
+直译为死键，西语体系下使用的特殊符号，中文中无对应概念。
+
+### flashing（firmware）
+使用“刷写”而非容易迷惑的“刷新”
+
+### option/configuration/setting
+根据上下文灵活考虑。对于组件化配置的概念，如一个功能支持与否，使用“配置”一词；对于客观上一定存在的某项设置值，使用“设置”一词。
+
+### commit/push/pull等Git术语
+倾向于不翻译。这些词语的对应中文词语过于宽泛或词性不明，非常容易混淆上下文。