Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

simpler docs #921

Merged
merged 7 commits into from
Sep 9, 2024
Merged

simpler docs #921

merged 7 commits into from
Sep 9, 2024

Conversation

KristopherPaulsen
Copy link
Contributor

@KristopherPaulsen KristopherPaulsen commented Aug 30, 2024

Improved the docs around v3 config to:

  • Make it more obvious that many fields are now nested under agent:
  • Remove fields which should not be included in agent configurations, but are instead top level fields (eg. version)
  • Simplfy examples
  • Modify examples that include code snippets to explicitly nest relevant fields under agent
  • Remove the "full example config" and replace with various smaller configuration examples.

There's still a lot here to look over, so an extra pair of eyes is always nice!

Copy link

vercel bot commented Aug 30, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated (UTC)
ngrok-docs ✅ Ready (Inspect) Visit Preview Sep 9, 2024 7:23pm

@@ -621,4 +619,237 @@ Edges automatically create an `edge` label, for example: `edge=edghts_2gYaK9XAVa

:::

<AgentConfigurations />
## Agent Configuration
Copy link
Contributor Author

@KristopherPaulsen KristopherPaulsen Sep 3, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I could try to get clever and piece out just the parts that are shared (now that v2 and v3 have diverged), but I instead copy-pasted and updated just the differences for v3.

This seems like a good call since:

  • It's easier to change without causing regressions with the v2 fields (if were tried to share the markup)
  • We're going to update these sections further, which makes anything that is "easy to throw away / delete" a good choice in my mind.
  • It's grug brain and simple.

@@ -506,7 +181,7 @@ You can configure a single ngrok agent to start multiple endpoints to different
| [`policy.outbound.actions.type`](/docs/http/traffic-policy/actions/index.mdx) | String | `policy` has been renamed to `traffic_policy` in agent version 3.14.0. |
| [`policy.outbound.actions.config`](/docs/http/traffic-policy/actions/index.mdx) | custom | `policy` has been renamed to `traffic_policy` in agent version 3.14.0. |
| `proto` | `http` | The endpoint protocol name. This defines the type of endpoint you would like to start. |
| `proxy_proto` | String | The version of [PROXY protocol](https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt) to use with this endpoint, empty if not using. Example values are 1 or 2. |
| `proxy_protocol` | String | The version of [PROXY protocol](https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt) to use with this endpoint, empty if not using. Example values are 1 or 2. |
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed naming

docs/agent/config/v3.mdx Outdated Show resolved Hide resolved
docs/agent/config/v3.mdx Outdated Show resolved Hide resolved
docs/agent/config/v3.mdx Outdated Show resolved Hide resolved
docs/agent/config/v3.mdx Outdated Show resolved Hide resolved
docs/agent/config/v3.mdx Outdated Show resolved Hide resolved
docs/agent/config/v3.mdx Show resolved Hide resolved
docs/agent/config/v3.mdx Outdated Show resolved Hide resolved
docs/agent/config/v3.mdx Outdated Show resolved Hide resolved
docs/agent/config/v3.mdx Outdated Show resolved Hide resolved
docs/agent/config/v3.mdx Outdated Show resolved Hide resolved
Copy link

@tammybailey tammybailey left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please fix the "check out"

docs/agent/config/v3.mdx Outdated Show resolved Hide resolved
#
# List of TLS endpoint configuration fields:
# https://ngrok.com/docs/agent/config/v3/#tls-configuration
### Endpoints with a traffic policy (file path)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm fine if you don't change it but Endpoints -> Endpoint (there's just one!)

@KristopherPaulsen KristopherPaulsen merged commit bbe325b into main Sep 9, 2024
2 of 3 checks passed
@KristopherPaulsen KristopherPaulsen deleted the kc/simpler-docs branch September 9, 2024 19:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants