Skip to content

Commit 9a81771

Browse files
authored
[docs] User concept section improvements (#1940)
* [docs] User concept section improvements - Removed the release number confusion - Better explanation for sharing section along with addition of `Public Link/Gist Sharing` content from blog and beta `share to slack` feature section (separate section when V1 released)
1 parent 791ed6a commit 9a81771

File tree

1 file changed

+52
-2
lines changed

1 file changed

+52
-2
lines changed

docs/docs-site/content/user/concept/_index.md

Lines changed: 52 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -45,13 +45,13 @@ This assistant content depends on the context of the application selected and wi
4545

4646
### Sample popup
4747

48-
This popup offers a quick way to see sample of the data and other statistics on databases, tables, and columns. You can open the popup from the SQL Assist or with a right-click on any SQL object (table, column, function…). In this release, it also opens faster and caches the data.
48+
This popup offers a quick way to see sample of the data and other statistics on databases, tables, and columns. You can open the popup from the SQL Assist or with a right-click on any SQL object (table, column, function…).
4949

5050
![Sample popup Navigation](https://cdn.gethue.com/uploads/2018/05/SQL_Context_Navigation.gif)
5151

5252
## Documents
5353

54-
Similarly to Google Documents, any document (e.g. SQL Query, Workflow, Dashboard...) opened in the Hue apps can be saved.
54+
Similarly to Google Documents, any document (e.g. SQL Query, Workflow, Dashboard...) opened in the Hue apps can be shared with other users or groups.
5555

5656
### Sharing
5757

@@ -66,6 +66,56 @@ Shared documents will show-up with a little blue icon.
6666

6767
![Sharing](https://cdn.gethue.com/uploads/2019/04/editor_sharing.png)
6868

69+
Along with document sharing, there is another query sharing option via links which is quicker and easier - **Public Links & Gist Sharing**
70+
71+
#### Public Links
72+
73+
Public links are the same as in Google documents which helps in quickly sharing parameterized saved reports, customer analyses links. They only require the recipient to have a Hue login. People can then reuse the queries on their own by executing them to see the results, fork and adapt them.
74+
75+
- No need to select groups or list of individual users
76+
- Read, write permissions
77+
- Linked documents won't show up in your home
78+
- Can be turned off globally
79+
- Can be combined with traditional user/group sharing
80+
81+
Here is the sharing popup with the public link option on the top when globally enabled:
82+
83+
![Public Link](https://cdn.gethue.com/uploads/2020/03/editor_sharing_popup.png)
84+
85+
#### Gist Sharing - SQL Snippet
86+
87+
Answering a question via a query result? Showing some weird data to a slack channel? Gist are a great quick way to quickly share SQL snippets, with a direct link to the SQL editor.
88+
89+
- Works with an SQL snippet: one or more statements
90+
- The link automatically point to the editor and the SQL content
91+
- The query is displayed in the friendlier ![presentation mode](https://docs.gethue.com/user/querying/#presentation)
92+
- Slack unfurling will show a mini preview (can be turned off globally)
93+
- Gists are stored in a Gist directory in your home
94+
95+
Here is an example:
96+
97+
Select a portion of statements to quick share with a Slack channel:
98+
99+
![Get Sharable Link](https://cdn.gethue.com/uploads/2020/03/editor_sharing_gist_menu.png)
100+
101+
The link to the SQL fragment is automatically generated:
102+
103+
![Gist](https://cdn.gethue.com/uploads/2020/03/editor_sharing_gist_popup.png)
104+
105+
Just paste the link in the Slack channel and users will get a mini preview:
106+
107+
![Gist in Slack](https://cdn.gethue.com/uploads/2020/03/editor_gist_slack.png)
108+
109+
Clicking on the link will open-up the SQL selection:
110+
111+
![Click Gist](https://cdn.gethue.com/uploads/2020/03/editor_gist_open_presentation_mode.png)
112+
113+
### Share to Slack
114+
Currently in **Beta**
115+
116+
This integration increases the collaboration with others via Slack. It expands the ability to share query links or gists to the desired Slack channels which then unfurls in a rich preview for other members to view.
117+
118+
69119
### Import / Export
70120

71121
Via the Home page, saved documents can be exported for backups or transferring to another Hue.

0 commit comments

Comments
 (0)