nGQL 加注释，让这条查询语句更有可读性

社区的小伙伴大多数都是通过文档来上手 NebulaGraph 自研的查询语言——nGQL，而 nGQL 因为是自研的查询语言的缘故，虽然它是一个声明式、同编程思维类似的查询语言，但是依旧是一个需要一点学习成本的语言。因此，NebulaGraph 文档对每个子句的用法给出了大量的示例，比如 MATCH 子句的用法： `

`nebula> MATCH (v) \
        WITH v, properties(v) as props, keys(properties(v)) as kk \
        WHERE [i in kk where props[i] == "Tim Duncan"] \
        RETURN v;
+----------------------------------------------------+
| v                                                  |
+----------------------------------------------------+
| ("player100" :player{age: 42, name: "Tim Duncan"}) |
+----------------------------------------------------+

nebula> WITH ['Tim Duncan', 'Yao Ming'] AS names \
        MATCH (v1:player)-->(v2:player) \
        WHERE v1.player.name in names \
        RETURN v1, v2;
+----------------------------------------------------+----------------------------------------------------------+
| v1                                                 | v2                                                       |
+----------------------------------------------------+----------------------------------------------------------+
| ("player133" :player{age: 38, name: "Yao Ming"})   | ("player114" :player{age: 39, name: "Tracy McGrady"})    |
| ("player133" :player{age: 38, name: "Yao Ming"})   | ("player144" :player{age: 47, name: "Shaquille O'Neal"}) |
| ("player100" :player{age: 42, name: "Tim Duncan"}) | ("player101" :player{age: 36, name: "Tony Parker"})      |
| ("player100" :player{age: 42, name: "Tim Duncan"}) | ("player125" :player{age: 41, name: "Manu Ginobili"})    |
+----------------------------------------------------+----------------------------------------------------------+

读到这里，细心的小伙伴可能发现了一个问题，这两个示例在干嘛？WITH 子句有用什么功能？

没错，文档虽然给出了很多用法示例，但是对每个语句缺少语句讲解，让每个语句被阅读的人更快地理解到它的作用，这对新手尤其重要，可以让他们在各个语句的作用中快速了解子句的查询表达力。

因此，即日开始至 2024.03.31 期间，便是 NebulaGraph 查询语句注释活动时间。希望我们度过这个寒冬之后，能在明媚的春天看到不一样的 nebula-docs。

PART.01 活动介绍在本次语句添加注释活动中，你可以给现有的 NebulaGraph 文档添加注释，因为 NebulaGraph 发行版众多。本次活动选用最新发行版（v3.6.0），根据现有文档的设定，最新发行版的内容将会同步到后续的发行版。这样，近期将会发布的 v3.7.0 也能收录你为 nGQL 编写的注释。