Skip to content

Commit 509956e

Browse files
Merge pull request #46 from RedisInsight/main
Releasing new vector similarity tutorials
2 parents 86aa34b + 5c97f31 commit 509956e

File tree

4 files changed

+331
-17
lines changed

4 files changed

+331
-17
lines changed

README.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
## Introduction
22

33
Tutorials are interactive documents that contain helpful use cases, comments, and related demonstrations of Redis features to help you level up your Redis game.
4-
You can use RedisInsight's built-in tutorials to explore powerful Redis capabilities or create custom tutorials to present your experience using RedisInsight and share them with others.
4+
You can use Redis Insight built-in tutorials to explore powerful Redis capabilities or create custom tutorials to present your experience using Redis Insight and share them with others.
55

66
This page provides an overview of the Tutorials structure and its elements. It also contains instructions, recommendations, and best practices for creating, updating and sharing Tutorials.
77

@@ -27,7 +27,7 @@ Tutorials should be combined into a .zip archive that contains the following:
2727
## Examples
2828
If you are interested in creating your own tutorials and would like to understand how they work, you can start with the following steps:
2929
- Download this example.
30-
- Open RedisInsight.
30+
- Open Redis Insight.
3131
- Navigate to the Insights panel (top right corner).
3232
- Find the "My Tutorials" section on the "Explore" tab.
3333
- Click the "Upload Tutorial" button and select the example.
@@ -59,7 +59,7 @@ If you would like to add a button to run commands, use a Redis Code block that i
5959
Basic [markdown syntax](https://www.markdownguide.org/basic-syntax/#images-1) provides the ability to render images.
6060

6161
To render images, you need to provide either an external URL to these images or a relative path to a folder inside of your tutorials.
62-
The folder with images can have any name, but it is recommended to start it with an underscore (_) or a dot (.) to avoid displaying it in RedisInsight in cases when the [manifest](#Manifest) is automatically generated.
62+
The folder with images can have any name, but it is recommended to start it with an underscore (_) or a dot (.) to avoid displaying it in Redis Insight in cases when the [manifest](#Manifest) is automatically generated.
6363

6464
Use the following logic to specify a relative path:
6565

@@ -76,7 +76,7 @@ For example:
7676
## Manifest
7777

7878
`manifest.json` is an optional file that describes the structure and behavior of Tutorials.
79-
If not specified, then RedisInsight will use the following logic:
79+
If not specified, then Redis Insight will use the following logic:
8080

8181
1. the tutorial name is defined based on the name of the `.zip` archive
8282
2. Page names are defined based on the file names in the `.zip` archive
@@ -91,11 +91,11 @@ below (it will be displayed as type "group"):
9191
|-------------------------|----------|---------------------------------------------------------------------|
9292
| label (**required**) | string | Label that will be displayed on UI for Node |
9393
| children (**required**) | Node[] | List of Nodes (nested groups or markdown files) |
94-
| type | | Can be skipped - RedisInsight will always use the "group" parameter |
95-
| author | string | _Not required, not displayed in RedisInsight_<br/> Author name |
96-
| URL | string | _Not required, not displayed in RedisInsight_<br/> link to repository/web-site |
97-
| industry | string[] | _Not required, not displayed in RedisInsight_<br/> tags to show relevant industry |
98-
| description | string | _Not required, not displayed in RedisInsight_<br/> short description of tutorials |
94+
| type | | Can be skipped - Redis Insight will always use the "group" parameter |
95+
| author | string | _Not required, not displayed in Redis Insight_<br/> Author name |
96+
| URL | string | _Not required, not displayed in Redis Insight_<br/> link to repository/web-site |
97+
| industry | string[] | _Not required, not displayed in Redis Insight_<br/> tags to show relevant industry |
98+
| description | string | _Not required, not displayed in Redis Insight_<br/> short description of tutorials |
9999

100100
Each Node requires a `label`,`type` (all available properties are described in the table below).
101101

@@ -120,7 +120,7 @@ A Node can be represented by various UI components and is specified by `type` pr
120120

121121
## Bulk Upload From Tutorials
122122

123-
You can upload sample data sets in bulk from your custom RedisInsight tutorials.
123+
You can upload sample data sets in bulk from your custom Redis Insight tutorials.
124124
To do so, you will need to:
125125
- create a text file with the list of Redis commands
126126
- add this file to the archive with your custom tutorials
@@ -139,8 +139,8 @@ The following syntax describes the `redis-upload` button:
139139
**Notes:**
140140

141141
* use only a relative path to the text file inside the tutorial folder
142-
* it is recommended to start the folder name with the text file from a dot (*.*) or underscore (*_*), so in the cases when the `manifest,json` file is automatically generated, RedisInsight will ignore this folder and not display it in your custom tutorial
143-
* all the files included in your custom tutorials will be stored inside the RedisInsight folder as long as the tutorials exist in RedisInsight, so instead of including large text files in your custom tutorials, consider using Bulk Upload in Browser
142+
* it is recommended to start the folder name with the text file from a dot (*.*) or underscore (*_*), so in the cases when the `manifest,json` file is automatically generated, Redis Insight will ignore this folder and not display it in your custom tutorial
143+
* all the files included in your custom tutorials will be stored inside the Redis Insight folder as long as the tutorials exist in Redis Insight, so instead of including large text files in your custom tutorials, consider using Bulk Upload in Browser
144144

145145
**Example:**
146146

@@ -176,7 +176,7 @@ as an absolute path from the tutorial folder.
176176
## Advanced
177177

178178
You can customize the run parameters to configure the raw mode, pipeline parameter and group mode. If specified, they will override
179-
the configuration set in RedisInsight. If not specified - the behaviour will be defined by parameters set in RedisInsight.
179+
the configuration set in Redis Insight. If not specified - the behaviour will be defined by parameters set in Redis Insight.
180180
To specify the parameters, insert them after the `redis:` and add the parameters in square brackets separated with a semicolon (`;`) in
181181
the following way:
182182

@@ -193,8 +193,8 @@ _Supported parameters:_
193193
| results | * _single_<br/>* _group_<br/>* _silent_ | If enabled, then pipeline mode is ignored | * _single_ - Disable the group mode to display the command results in a batch or as separate ones.<br/>* _group_ - Enable the group mode <br/>* _silent_: <br/>&emsp; 1. Enable the group mode <br/>&emsp; 2. Auto collapse the result <br/>&emsp; 3. Show only error commands in the results. |
194194
| mode | * _ascii_<br/>* _raw_ | | Enable/disable the raw mode to display command results. |
195195
| pipeline | any integer number | | Configure the number of commands in the pipeline. 0 or 1 pipelines every command. |
196-
| run_confirmation | * _true_ | If set to _true_, RedisInsight will display confirmation dialog to run the commands | Enabling this parameter shows for particular query confirmation dialog. |
197-
| executable | * _false_ | If set to _false_, RedisInsight will not display the "Run" button and will not the command to be executed, although the syntax will be highlighted. | Defines if the "Run" button will be displayed to run the command. |
196+
| run_confirmation | * _true_ | If set to _true_, Redis Insight will display confirmation dialog to run the commands | Enabling this parameter shows for particular query confirmation dialog. |
197+
| executable | * _false_ | If set to _false_, Redis Insight will not display the "Run" button and will not the command to be executed, although the syntax will be highlighted. | Defines if the "Run" button will be displayed to run the command. |
198198

199199
_Notes:_
200200

@@ -215,7 +215,7 @@ redis:[pipeline=8;mode=raw;results=single;]
215215
### Links configuration
216216

217217
#### Internal links
218-
You can insert links that lead to a specific page inside RedisInsight. The syntax for these links is following:
218+
You can insert links that lead to a specific page inside Redis Insight. The syntax for these links is following:
219219
```
220220
[{text}](redisinsight:{path})
221221
```
@@ -245,7 +245,7 @@ The full list of pages:
245245

246246
#### Create a free Cloud database link
247247

248-
Also, there is a possibility to insert link which opens Create Free Database dialog inside RedisInsight
248+
Also, there is a possibility to insert link which opens Create Free Database dialog inside Redis Insight
249249

250250
> *Note*: For Docker builds these links will work as pure external links
251251
Syntax:

src/manifest.json

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -344,6 +344,22 @@
344344
"path": "/sq/aggregations.md"
345345
}
346346
},
347+
{
348+
"type": "internal-link",
349+
"id": "sq-vectors-basic",
350+
"label": "Vector search (basic)",
351+
"args": {
352+
"path": "/sq/vectors-basic.md"
353+
}
354+
},
355+
{
356+
"type": "internal-link",
357+
"id": "sq-vectors-adv-hash",
358+
"label": "Vector search (advanced)",
359+
"args": {
360+
"path": "/sq/vectors-adv-hash.md"
361+
}
362+
},
347363
{
348364
"type": "internal-link",
349365
"id": "sq-learn-more",

0 commit comments

Comments
 (0)