Skip to content

docs: fix typos and clarity - #181

Merged
encodeous merged 5 commits into
mainfrom
docs/fix-typos-and-clarity
Nov 3, 2026
Merged

encodeous merged 5 commits into
mainfrom
docs/fix-typos-and-clarity

Conversation

@alexstarosta

Copy link
Copy Markdown
Collaborator

Went though some of the documentation and comments and noticed some out of date things/typos:

  • fixed some links that were not live
  • fixed some outdated instructions
  • clarified some comments/edited comments that looked out of place
  • fixed some general typos + markdown mistakes

Please let me know if I misconstrued some of the documentation. I did some digging and this all lines up with my mental model and local network.

The README said the sample systemd and launchd files are under
`examples`, but the directory is `example/`, so name it correctly and
link it. The Windows note linked to /guides/wg-clients, a docs site
route that 404s on GitHub, so use the absolute nylon.jq.ax URL like the
README's other docs links.
The config distribution section said to put the bundle URL in the node
config under `dist/url`, which node.yaml no longer accepts, and that
nylon downloads the config before starting up. It also said `nylon seal`
uses the public key, when it reads the private key from `central.key`.
List the URL under `dist.repos` in central.yaml, say that every node
still needs central.yaml before its first start, link the config
distribution guide, and write `dist.key` as that guide does.

The last tip said to run `nylon i`, which no longer exists. Point to
`nylon status -i <interface_name>`, and say what --routes and --full
add to its output.
The comment on the sample's `type: http` prefix compared it to itself;
it means the ping check above it. The url comment said only that the
check expects a success response, but anything other than HTTP 200 is a
failure. Unlike ping there is also no max_failures: any failed request
stops advertising the prefix until the next successful one.
`nylon run --json` only changes the console log on stderr; the log file
stays in text format. `nylon open` prints the parsed config to stderr
too, and stdout stays empty. The help text said neither.
@encodeous

Copy link
Copy Markdown
Owner

lgtm!

@encodeous
encodeous merged commit e7368df into main Nov 3, 2026
9 checks passed
@encodeous
encodeous deleted the docs/fix-typos-and-clarity branch November 3, 2026 04:18
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.

2 participants