docs(Get started rework): Revise the Insomnia allowlist page #227
Conversation
Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
|
|
||
| To fully utilize Insomnia, please ensure the following domains are whitelisted: | ||
| | Hostname | Description | |
There was a problem hiding this comment.
@fabianrbz I added a table here and a note below like we have in our docs repo, but they aren't quite rendering correctly. I probably don't have to use the note format, I could change it to something else if it's too difficult to add that formatting in this repo. But I'd like to keep the table. Is the table formatting something you could add?
There was a problem hiding this comment.
@cloudjumpercat It's rendering an HTML table, the problem is that it doesn't have any styles applied,
I've pushed a commit to this branch that applies Bootstrap's default table styles to all the tables. Hopefully, that's enough (we can always tweak those).
Let's keep track of all the style differences.
There was a problem hiding this comment.
@fabianrbz Thanks!
Let's keep track of all the style differences.
Where would be the best place to keep track of the differences?
There was a problem hiding this comment.
@fabianrbz I started documenting the differences in the styling Jira ticket: https://konghq.atlassian.net/browse/DOCU-3897. The table looks good for this doc, so we can just leave the default styling for now in this PR and if you want to make any adjustments in another PR/the styling PR, that would work!
| @@ -3,60 +3,29 @@ layout: article-detail | |||
| title: Allowlist for Insomnia | |||
| --- | |||
|
|
|||
| <!-- for docs rework: revise this page like we normally would --> | |||
| For enterprise users utilizing Insomnia, it's crucial to ensure that specific domains are allowlisted in your network. This step is essential to guarantee that all features of Insomnia, including updates, synchronization, documentation, and necessary backend services work without any hindrance in environments with restricted internet access. | |||
There was a problem hiding this comment.
@filfreire I didn't edit this paragraph yet because I wanted to double check with you first: this doc applies to any users who have restricted internet access, right? Not just enterprise customers?
|
|
|
|
| @@ -3,60 +3,29 @@ layout: article-detail | |||
| title: Allowlist for Insomnia | |||
| --- | |||
|
|
|||
| <!-- for docs rework: revise this page like we normally would --> | |||
| For enterprise users utilizing Insomnia, it's crucial to ensure that specific domains are allowlisted in your network. This step is essential to guarantee that all features of Insomnia, including updates, synchronization, documentation, and necessary backend services work without any hindrance in environments with restricted internet access. | |||
There was a problem hiding this comment.
I don't really see the value in this paragraph. I think it should just kind of introduce the table.
|
|
||
| ## Introduction | ||
| If you have issues after allowlisting Insomnia hostnames, contact your IT support or reach out to Insomnia's customer service at <support@insomnia.rest> or <https://support.konghq.com/support/s/>. |
There was a problem hiding this comment.
I think this shoudl go after the table.
|
|
||
| Whitelisting these domains ensures uninterrupted access to all functionalities of Insomnia, including updates, documentation, and necessary backend services. Should you experience issues post-whitelisting, it's advisable to seek assistance from your IT support or reach out to Insomnia's customer service at <support@insomnia.rest> OR <https://support.konghq.com/support/s/>. | ||
| {:.note} | ||
| > **Individual Insomnia users:** If you’re an individual user, ask your IT department to allowlist these hostnames to enable full functionality of Insomnia in your workspace. |
There was a problem hiding this comment.
Is there another way to describe 'individual user'?
There was a problem hiding this comment.
@Guaris After making your other suggestions, I realized we didn't need this note because the doc implies that everyone needs to allowlist these.
Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
Summary
Reason
DOCU-3909
Testing