Skip to content

Commit 3a934fb

Browse files
committed
polish doc
Signed-off-by: he1pa <[email protected]>
1 parent 27e8482 commit 3a934fb

File tree

3 files changed

+33
-33
lines changed

3 files changed

+33
-33
lines changed

docs/tools/Ide/intellij.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ sidebar_position: 3
66

77
## Quick Start
88

9-
- **Step 1.** [Install KCL](https://kcl-lang.io/docs/user_docs/getting-started/install) on your system. Please check that `kcl` and `kcl-language-server` are installed and have been added to your PATH:
10-
In MacOs and Linux:
9+
- **Step 1.** [Install KCL](https://kcl-lang.io/docs/user_docs/getting-started/install) on your system. Please ensure that `kcl` and `kcl-language-server` are installed and added to your PATH:
10+
On MacOS and Linux:
1111

1212
```bash
1313
which kcl
@@ -21,41 +21,41 @@ sidebar_position: 3
2121
where kcl-language-server
2222
```
2323

24-
- **Step 2.** Install the [KCL plugin](https://plugins.jetbrains.com/plugin/23378-kcl) from Jetbrains Plugins Marketplace .
25-
- **Step 3.** Reopen IntelliJ IDEA and create a KCL file and begin your KCL tour!
24+
- **Step 2.** Install the [KCL plugin](https://plugins.jetbrains.com/plugin/23378-kcl) from the Jetbrains Plugins Marketplace.
25+
- **Step 3.** Reopen IntelliJ IDEA, create a KCL file, and begin your KCL journey!
2626

2727
## Features
2828

29-
This extension provides many coding assistance based on Language Server Protocol.
29+
This extension provides comprehensive coding assistance based on the Language Server Protocol.
3030

31-
- **Highlight:** Syntax and semantic highlight
32-
- **Completion:** Completion for keywords, variable name, attributes and more
33-
- **Goto definition:** Goto definition of schema, variable, schema attribute, and import pkg
34-
- **Structure:** Main definition(schema def) and variables in KCL file
35-
- **Hover:** Identifier information (type and schema documentation)
36-
- **Diagnostics:** Warnings and errors in KCL file
31+
- **Highlighting:** Syntax and semantic highlighting
32+
- **Code Completion:** Completion for keywords, variable names, attributes, and more
33+
- **Goto definition:** Navigate to the definition of schema, variables, schema attributes, and imported packages
34+
- **Structure:** View the main definition (schema definition) and variables in KCL files
35+
- **Hover:** View identifier information (type and schema documentation)
36+
- **Diagnostics:** Detect warnings and errors in KCL files
3737
- **Code Action:** Quick fix for some errors
38-
- **InlayHint:** Hint for variable type, function and schema args
38+
- **InlayHint:** Display hints for variable type, functions, and schema arguments
3939

40-
Other useful features such as diagnostics and testing are in developing.
40+
Other useful features such as diagnostics and testing are under development.
4141

4242
## Dependencies
4343

44-
We recommend that you use the latest version of KCL, but the minimum required version for this extension is 0.4.6. If you are using an earlier version, the extension may not work properly.
44+
We recommend using the latest version of KCL, but the minimum required version for this extension is 0.4.6. If you are using an earlier version, the extension may not work properly.
4545

46-
The minimun required version for IntelliJ IDEA is 2022.1
46+
The minimum required version for IntelliJ IDEA is 2022.1.
4747

4848
## Known Issues
4949

5050
See [here](https://github.com/kcl-lang/kcl/issues).
5151

5252
## Ask for help
5353

54-
If the extension isn't working as you expect, please contact us with [community](https://kcl-lang.io/docs/community/intro/support) for help.
54+
If the extension does not behave as expected, please reach out to us through the [community](https://kcl-lang.io/docs/community/intro/support) for assistance.
5555

5656
## Contributing
5757

58-
We are working actively on improving the KCL development on VS Code. All kinds of contributions are welcomed. You can refer to our [contribution guide](https://kcl-lang.io/docs/community/contribute). It introduces how to build and run the extension locally, and describes the process of sending a contribution.
58+
We are actively working to enhance KCL development on VS Code. We welcome all types of contributions. You can consult our [contribution guide](https://kcl-lang.io/docs/community/contribute), which explains how to build and run the extension locally and describes the contribution process.
5959

6060
## License
6161

docs/tools/Ide/vs-code.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ sidebar_position: 1
66

77
## Quick Start
88

9-
- **Step 1.** [Install KCL](https://kcl-lang.io/docs/user_docs/getting-started/install) on your system. Please check that `kcl` and `kcl-language-server` are installed and have been added to your PATH:
10-
In MacOs and Linux:
9+
- **Step 1.** [Install KCL](https://kcl-lang.io/docs/user_docs/getting-started/install) on your system. Please ensure that `kcl` and `kcl-language-server` are installed and added to your PATH:
10+
On MacOS and Linux:
1111

1212
```bash
1313
which kcl
@@ -22,23 +22,23 @@ sidebar_position: 1
2222
```
2323

2424
- **Step 2.** Install the [KCL extension](https://marketplace.visualstudio.com/items?itemName=kcl.kcl-vscode-extension) for Visual Studio Code. This extension requires the VS Code 1.50+.
25-
- **Step 3.** Reopen VS Code and create a KCL file and begin your KCL tour!
25+
- **Step 3.** Reopen VS Code, create a KCL file, and begin your KCL journey!
2626

2727
## Features
2828

2929
This extension provides some coding assistance, including the following features:
3030

31-
- **Syntax Highlight:**
31+
- **Highlighting:**
3232
![Highlight](/img/docs/tools/Ide/vs-code/Highlight.png)
33-
- **Goto Definition:** Goto definition of schema, variable, schema attribute, map key and import pkg.
33+
- **Goto Definition:** Navigate to the definition of schema, variables, schema attributes, and imported packages
3434
![Goto Definition](/img/docs/tools/Ide/vs-code/GotoDef.gif)
35-
- **Completion:** Completion for keywords, dot(`.`), variables and schema attribute.
35+
- **Completion:** Completion for keywords, variable names, attributes, and more
3636
![Completion](/img/docs/tools/Ide/vs-code/Completion.gif)
37-
- **Outline:** Main definition(schema def) and variables in KCL file.
37+
- **Outline:** View the main definition (schema definition) and variables in KCL files
3838
![Outline](/img/docs/tools/Ide/vs-code/Outline.gif)
39-
- **Hover:** Identifier information (type, function signature and documents).
39+
- **Hover:** View identifier information (type and schema documentation)
4040
![Hover](/img/docs/tools/Ide/vs-code/Hover.gif)
41-
- **Diagnostics:** Warnings and errors in KCL file.
41+
- **Diagnostics:** Detect warnings and errors in KCL files
4242
![Diagnostics](/img/docs/tools/Ide/vs-code/Diagnostics.gif)
4343

4444
> Tips: You can enhance the effect of diagnostics by installing another extension: [Error Lens](https://marketplace.visualstudio.com/items?itemName=usernamehw.errorlens).
@@ -47,26 +47,26 @@ This extension provides some coding assistance, including the following features
4747
![Format](/img/docs/tools/Ide/vs-code/Format.gif)
4848
- **Quick fix:** Quick fix some diagnostics
4949
![Qucik Fix](/img/docs/tools/Ide/vs-code/QuickFix.gif)
50-
- **Inlay hint:** Inlay hint displays variable type and other semantic information
50+
- **Inlay hint:** Display hints for variable type, functions, and schema arguments
5151
![Inlay Hint](/img/docs/tools/Ide/vs-code/Inlayhint.png)
5252

5353
Other useful features such as refactoring and testing are in development.
5454

5555
## Dependencies
5656

57-
We recommend that you use the latest version of KCL, but the minimum required version for this extension is 0.4.6. If you are using an earlier version, the extension may not work properly.
57+
We recommend using the latest version of KCL, but the minimum required version for this extension is 0.4.6. If you are using an earlier version, the extension may not work properly.
5858

5959
## Known Issues
6060

6161
See [here](https://github.com/kcl-lang/kcl/issues).
6262

6363
## Ask for help
6464

65-
If the extension isn't working as you expect, please contact us with [community](https://kcl-lang.io/docs/community/intro/support) for help.
65+
If the extension does not behave as expected, please reach out to us through the [community](https://kcl-lang.io/docs/community/intro/support) for assistance.
6666

6767
## Contributing
6868

69-
We are working actively on improving the KCL development on VS Code. All kinds of contributions are welcomed. You can refer to our [contribution guide](https://kcl-lang.io/docs/community/contribute). It introduces how to build and run the extension locally, and describes the process of sending a contribution.
69+
We are actively working to enhance KCL development on VS Code. We welcome all types of contributions. You can consult our [contribution guide](https://kcl-lang.io/docs/community/contribute), which explains how to build and run the extension locally and describes the contribution process.
7070

7171
## License
7272

docs/user_docs/getting-started/install.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -204,18 +204,18 @@ scoop install kcl-lang/kcl-lsp
204204

205205
#### VS Code
206206

207-
The KCL Extension extension provides some coding assistance, e.g., highlight, goto definition, completion, hover, outline, and diagnostics. You can go [here](/docs/tools/Ide/vs-code) for more information about the installation.
207+
The KCL Extension provides comprehensive coding assistance, offering features such as highlighting, go-to definition, completion, hover, outline, and diagnostics. For more information about the installation, please visit [here](/docs/tools/Ide/vs-code)
208208

209209
![Completion](/img/docs/tools/Ide/vs-code/Completion.gif)
210210

211211
#### NeoVim
212212

213-
See [here](/docs/tools/Ide/neovim) to config the KCL language server and enable it.
213+
To configure the KCL language server and enable it, please refer to [here](/docs/tools/Ide/neovim)
214214

215215
![kcl.nvim](/img/docs/tools/Ide/neovim/overview.png)
216216

217217
#### IntelliJ IDEA
218218

219-
We provide IntelliJ KCL plugins and you can go [here](/docs/tools/Ide/intellij) for more information about the installation.
219+
We offer IntelliJ KCL plugins. For detailed information about the installation, please visit [here](/docs/tools/Ide/intellij)
220220

221221
![intellij](/img/docs/tools/Ide/intellij/overview.png)

0 commit comments

Comments
 (0)