Revise the Universal Gateway Overview page #1647
Conversation
sg-writer
added
docs/content
universal-gateway/overview.mdx
Outdated
| description: Learn about ngrok's suite of common tools for building API and device gateways, identity-aware proxies, and site-to-site connectivity. | ||
| --- | ||
|
|
||
| ngrok's Universal Gateway is a suite of common tools for building API and device gateways, identity-aware proxies, and site-to-site connectivity. |
There was a problem hiding this comment.
device gateways, identity-aware proxies, and site-to-site connectivity
How would you feel about adding all 3 of these terms to the definition wrapper? You'd have to add it to the array at the top ofdefinition-wrapper.js(it's set up that way due to mintlify limitations)
My reasoning: It feels like if you don't already know what those are, we've lost you.
Also, it may be worth incorporating some of your explanation of what makes it universal in this opening paragraph.
Something like
ngrok's Universal Gateway is a suite of tools that secure, accelerate, and protect your applications wherever they're running. The Universal gateway empowers you to build API and device gateways, identity-aware proxies, site-to-site connectivity, and more.
That's a little rough, but the vision is that the opening would lead with more universally comprehensible concepts before getting technical and specific. This is definitely a conversation-starter comment rather than a specifically requested change, so I'm curious your thoughts
There was a problem hiding this comment.
good call - we should get in the habit of adding to the definition list anytime we're editing a piece that includes undefined niche terms.
fresh PR so Mintlify will deploy a preview