Landing copy: no em dashes, inline colons or semicolons

Author: fstubner

site/src/data/site-content/changelog.ts

@@ -40,13 +40,13 @@ export const releaseSummaries: Record<string, string> = {
   'v0.2.4':
     'v0.2.3 built the GUI installers but never attached them. Publishing is repaired here, along with the AUR deploy action that was blocking Linux packages.',
   'v0.2.3':
-    'GUI installer builds move again once the Tauri JavaScript and Rust versions agree, and the AUR packaging handoff is fixed. CLI packages were already usable from v0.2.2; the GUI artifacts needed these pipeline fixes.',
+    'GUI installer builds move again once the Tauri JavaScript and Rust versions agree, and the AUR packaging handoff is fixed. CLI packages were already usable from v0.2.2, and the GUI artifacts needed these pipeline fixes.',
   'v0.2.2':
     'This is a release-pipeline recovery build. It refreshes Cargo.lock so locked release builds can run reproducibly after dependency bumps, giving package-manager users a working replacement for the failed v0.2.1 artifacts.',
   'v0.2.1':
     'Desktop installers and signed release assets mean you no longer need a Rust toolchain to install. Adds concurrency tuning for networks that struggle with large parallel scans.',
   'v0.2.0':
-    'Turns the initial scanner into something distributable. mDNS discovery and typed core errors on the product side; shell completions, man pages, package-manager templates and signed artifacts on the shipping side.',
+    'Turns the initial scanner into something distributable. mDNS discovery and typed core errors on the product side, and shell completions, man pages, package-manager templates and signed artifacts on the shipping side.',
   'v0.1.1':
     'Cleans up the first public version with crate documentation, security notes and a structured changelog, plus the release workflow fixes that make binaries and pcap variants reproducible.',
   'v0.1.0':

site/src/data/site-content/faq.ts

@@ -29,7 +29,7 @@ export const faq: FaqItem[] = [
     // search engine and answer engine reads. The visible `aHtml` below was
     // already a template literal and rendered correctly, which is why the
     // page looked fine.
-    a: `Install the netscli package for the CLI, terminal UI, and MCP server. On Windows, run: winget install netscli (the full identifier fstubner.netscli also works). On Linux or macOS, run: ${INSTALL_SH_COMMAND}. For the desktop app, run winget install netscli-gui on Windows or brew install --cask fstubner/tap/netscli-gui on macOS, or download it from GitHub releases. Linux has a .deb and an AppImage. With Rust installed you can also run: cargo install netscli.`,
+    a: `Install the netscli package for the CLI, terminal UI, and MCP server. On Windows, run winget install netscli (the full identifier fstubner.netscli also works). On Linux or macOS, run ${INSTALL_SH_COMMAND}. For the desktop app, run winget install netscli-gui on Windows or brew install --cask fstubner/tap/netscli-gui on macOS, or download it from GitHub releases. Linux has a .deb and an AppImage. With Rust installed you can also run cargo install netscli.`,
     aHtml: `
       <p>Install the <code>netscli</code> package for the CLI, terminal UI, and MCP server:</p>
       <div class="faq-command-list" aria-label="Install commands">
@@ -48,9 +48,9 @@ export const faq: FaqItem[] = [
   {
     group: 'Interfaces and integrations',
     q: 'Can I use NetsCLI with Claude Code, Cursor, or another AI agent?',
-    a: 'Yes. Running `netscli serve` starts a Model Context Protocol (MCP) server over stdio. It exposes structured local-network tools for host discovery, port scanning, ping, DNS, ARP, host inspection, network sweep, interface listing, and mDNS discovery. Packet-capture builds can also expose capture tools. Packet capture uses a job-style flow for long-running work: start the capture, poll status, then fetch the result.',
+    a: 'Yes. Running `netscli serve` starts a Model Context Protocol (MCP) server over stdio. It exposes structured local-network tools for host discovery, port scanning, ping, DNS, ARP, host inspection, network sweep, interface listing, and mDNS discovery. Packet-capture builds can also expose capture tools. Packet capture uses a job-style flow for long-running work. Start the capture, poll status, then fetch the result.',
     aHtml:
-      'Yes. Running <code>netscli serve</code> starts a Model Context Protocol (MCP) server over stdio. It exposes structured local-network tools for host discovery, port scanning, ping, DNS, ARP, host inspection, network sweep, interface listing, and mDNS discovery. Packet-capture builds can also expose capture tools. Packet capture uses a job-style flow for long-running work: start the capture, poll status, then fetch the result.',
+      'Yes. Running <code>netscli serve</code> starts a Model Context Protocol (MCP) server over stdio. It exposes structured local-network tools for host discovery, port scanning, ping, DNS, ARP, host inspection, network sweep, interface listing, and mDNS discovery. Packet-capture builds can also expose capture tools. Packet capture uses a job-style flow for long-running work. Start the capture, poll status, then fetch the result.',
   },
   {
     group: 'Install and updates',
@@ -69,9 +69,9 @@ export const faq: FaqItem[] = [
   {
     group: 'Limits and dependencies',
     q: 'Does NetsCLI require libpcap or other system dependencies?',
-    a: 'Not for the normal scan, discovery, DNS, ARP, ping, trace, or interface workflows. Packet capture is the exception: it requires libpcap on Linux/macOS or Npcap on Windows at runtime, and only works in the separate packet-capture downloads.',
+    a: 'Not for the normal scan, discovery, DNS, ARP, ping, trace, or interface workflows. Packet capture is the exception. It requires libpcap on Linux/macOS or Npcap on Windows at runtime, and only works in the separate packet-capture downloads.',
     aHtml:
-      'Not for the normal scan, discovery, DNS, ARP, ping, trace, or interface workflows. Packet capture is the exception: it requires libpcap on Linux/macOS or Npcap on Windows at runtime, and only works in the separate packet-capture downloads.',
+      'Not for the normal scan, discovery, DNS, ARP, ping, trace, or interface workflows. Packet capture is the exception. It requires libpcap on Linux/macOS or Npcap on Windows at runtime, and only works in the separate packet-capture downloads.',
   },
   {
     group: 'Network workflows',
@@ -88,9 +88,9 @@ export const faq: FaqItem[] = [
     // folders and remote shutdown, and a comparison that omitted the thing a
     // reader can see on that page in ten seconds would discredit the rest of
     // the answer.
-    a: 'NetsCLI overlaps with those tools for common LAN discovery tasks: finding live hosts, scanning TCP ports, resolving hostnames, and showing MAC vendors from the local ARP cache. It is not a drop-in clone of either. Advanced IP Scanner is Windows-only and closed-source freeware. NetsCLI runs on Windows, macOS, and Linux, is MIT-licensed, and offers the same scans from a desktop app, a terminal UI, a CLI, and an MCP server, with JSON, YAML, CSV and Markdown output. Angry IP Scanner is also open source and cross-platform, and ships its own command-line interface. What NetsCLI does not do is remote administration: Advanced IP Scanner can open shared folders, control machines over RDP or Radmin, and switch them off remotely, and NetsCLI has no equivalent.',
+    a: 'NetsCLI overlaps with those tools for common LAN discovery tasks, such as finding live hosts, scanning TCP ports, resolving hostnames, and showing MAC vendors from the local ARP cache. It is not a drop-in clone of either. Advanced IP Scanner is Windows-only and closed-source freeware. NetsCLI runs on Windows, macOS, and Linux, is MIT-licensed, and offers the same scans from a desktop app, a terminal UI, a CLI, and an MCP server, with JSON, YAML, CSV and Markdown output. Angry IP Scanner is also open source and cross-platform, and ships its own command-line interface. NetsCLI does not do remote administration. Advanced IP Scanner can open shared folders, control machines over RDP or Radmin, and switch them off remotely, and NetsCLI has no equivalent.',
     aHtml:
-      'NetsCLI overlaps with those tools for common LAN discovery tasks: finding live hosts, scanning TCP ports, resolving hostnames, and showing MAC vendors from the local ARP cache. It is not a drop-in clone of either. Advanced IP Scanner is Windows-only and closed-source freeware. NetsCLI runs on Windows, macOS, and Linux, is MIT-licensed, and offers the same scans from a <a href="#surfaces">desktop app, terminal UI, CLI, and MCP server</a>, with <code>--json</code>, <code>--yaml</code>, <code>--csv</code> and <code>--md</code> output. Angry IP Scanner is also open source and cross-platform, and ships its own command-line interface. What NetsCLI does not do is remote administration: Advanced IP Scanner can open shared folders, control machines over RDP or Radmin, and switch them off remotely, and NetsCLI has no equivalent.',
+      'NetsCLI overlaps with those tools for common LAN discovery tasks, such as finding live hosts, scanning TCP ports, resolving hostnames, and showing MAC vendors from the local ARP cache. It is not a drop-in clone of either. Advanced IP Scanner is Windows-only and closed-source freeware. NetsCLI runs on Windows, macOS, and Linux, is MIT-licensed, and offers the same scans from a <a href="#surfaces">desktop app, terminal UI, CLI, and MCP server</a>, with <code>--json</code>, <code>--yaml</code>, <code>--csv</code> and <code>--md</code> output. Angry IP Scanner is also open source and cross-platform, and ships its own command-line interface. NetsCLI does not do remote administration. Advanced IP Scanner can open shared folders, control machines over RDP or Radmin, and switch them off remotely, and NetsCLI has no equivalent.',
   },
   {
     group: 'Network workflows',
@@ -112,8 +112,8 @@ export const faq: FaqItem[] = [
     aHtml: `
       <p>Yes. NetsCLI is MIT-licensed and free for personal, open-source, and commercial use.</p>
       <div class="faq-command-list" aria-label="Package manager commands">
-        <div class="faq-command"><span>Winget — CLI</span><code>winget install netscli</code></div>
-        <div class="faq-command"><span>Winget — app</span><code>winget install netscli-gui</code></div>
+        <div class="faq-command"><span>Winget (CLI)</span><code>winget install netscli</code></div>
+        <div class="faq-command"><span>Winget (app)</span><code>winget install netscli-gui</code></div>
         <div class="faq-command"><span>Scoop</span><code>scoop bucket add fstubner https://github.com/fstubner/scoop-bucket &amp;&amp; scoop install netscli</code></div>
         <div class="faq-command"><span>Homebrew</span><code>brew tap fstubner/tap &amp;&amp; brew install netscli</code></div>
         <div class="faq-command"><span>Install script</span><code>${INSTALL_SH_COMMAND}</code></div>
@@ -124,14 +124,14 @@ export const faq: FaqItem[] = [
   {
     group: 'Network workflows',
     q: 'Can NetsCLI replace nmap, and does it have a TUI?',
-    a: 'NetsCLI covers the simpler cases nmap is often reached for: host discovery, TCP and UDP port scans, DNS lookups, and ARP-table inspection on a local network, with direct subcommands and structured output. It also ships a terminal UI — run netscli with no arguments to get an interactive, keyboard-driven scanner in the terminal, which nmap itself does not provide. For advanced service detection, NSE scripts, and OS fingerprinting, nmap remains the better tool.',
+    a: 'NetsCLI covers the simpler cases nmap is often reached for, such as host discovery, TCP and UDP port scans, DNS lookups, and ARP-table inspection on a local network, with direct subcommands and structured output. It also ships a terminal UI. Run netscli with no arguments to get an interactive, keyboard-driven scanner in the terminal, which nmap itself does not provide. For advanced service detection, NSE scripts, and OS fingerprinting, nmap remains the better tool.',
     aHtml:
-      'NetsCLI covers the simpler cases nmap is often reached for: host discovery, TCP and UDP port scans, DNS lookups, and ARP-table inspection on a local network, with direct subcommands and structured output. It also ships a <a href="#surfaces">terminal UI</a> — run <code>netscli</code> with no arguments to get an interactive, keyboard-driven scanner in the terminal, which nmap itself does not provide. For advanced service detection, NSE scripts, and OS fingerprinting, nmap remains the better tool.',
+      'NetsCLI covers the simpler cases nmap is often reached for, such as host discovery, TCP and UDP port scans, DNS lookups, and ARP-table inspection on a local network, with direct subcommands and structured output. It also ships a <a href="#surfaces">terminal UI</a>. Run <code>netscli</code> with no arguments to get an interactive, keyboard-driven scanner in the terminal, which nmap itself does not provide. For advanced service detection, NSE scripts, and OS fingerprinting, nmap remains the better tool.',
   },
   {
     group: 'Network workflows',
     q: 'Is there a netscan command for Linux or Windows?',
-    a: 'There is no standard netscan command on Linux, macOS, or Windows. People searching for one usually want a command-line network scanner, which is what NetsCLI is: netscli discover lists live hosts on your subnet, netscli scan checks TCP or UDP ports on a host, and netscli sweep does both across a range. Several unrelated third-party tools also use the name NetScan, so check which one you mean before installing.',
+    a: 'There is no standard netscan command on Linux, macOS, or Windows. People searching for one usually want a command-line network scanner, which is what NetsCLI is. netscli discover lists live hosts on your subnet, netscli scan checks TCP or UDP ports on a host, and netscli sweep does both across a range. Several unrelated third-party tools also use the name NetScan, so check which one you mean before installing.',
     aHtml:
       '<p>There is no standard <code>netscan</code> command on Linux, macOS, or Windows. People searching for one usually want a command-line network scanner, which is what NetsCLI is:</p><div class="faq-command-list" aria-label="Scanning commands"><div class="faq-command"><span>Live hosts</span><code>netscli discover</code></div><div class="faq-command"><span>Ports on a host</span><code>netscli scan router.local -p 22,80,443</code></div><div class="faq-command"><span>Both, across a range</span><code>netscli sweep</code></div></div><p>Several unrelated third-party tools also use the name NetScan, so check which one you mean before installing.</p>',
   },

site/src/data/site-content/hero.ts

@@ -52,7 +52,7 @@ export const hero: Hero = {
     // it. "All on one Rust core" carries the same point as "each interface
     // calls the same Rust core, so results stay consistent" -- the reader who
     // needs the longer version is already reading /docs/.
-    'Discover LAN devices, scan TCP and UDP ports, query DNS, and inspect hosts from the desktop app, terminal UI, CLI, or MCP server — all on one Rust core.',
+    'Discover LAN devices, scan TCP and UDP ports, query DNS, and inspect hosts from the desktop app, terminal UI, CLI, or MCP server, all on one Rust core.',
   // `winget install netscli` leads, and the shell script follows.
   //
   // os-tabs.ts already swapped these per-OS at runtime -- Windows visitors

site/src/data/site-content/install.ts

@@ -4,7 +4,7 @@ import { INSTALL_PS1_COMMAND, INSTALL_SH_COMMAND } from './install-urls';
 export const installCopy: SectionCopy = {
   heading: 'Get started',
   leadHtml:
-    'Install the desktop app or the command line — both drive the same Rust core. <a href="/docs/install/">Full install guide →</a>',
+    'Install the desktop app or the command line. Both drive the same Rust core. <a href="/docs/install/">Full install guide →</a>',
 };
 
 const RELEASE_DOWNLOAD = 'https://github.com/fstubner/netscli/releases/latest/download';
@@ -24,7 +24,7 @@ const RELEASE_DOWNLOAD = 'https://github.com/fstubner/netscli/releases/latest/do
  *  refusal with no Open button. Apple's support page for opening an app from
  *  an unknown developer gives only the System Settings route, which is what
  *  this names now. */
-const MACOS_UNSIGNED_HINT = 'Unsigned — open it once, then System Settings → Privacy & Security → Open Anyway';
+const MACOS_UNSIGNED_HINT = 'Unsigned. Open it once, then System Settings → Privacy & Security → Open Anyway';
 
 export const installByPlatform: Record<Platform, PlatformInstall> = {
   windows: {
@@ -128,7 +128,7 @@ export const installByPlatform: Record<Platform, PlatformInstall> = {
       {
         label: 'AppImage',
         href: `${RELEASE_DOWNLOAD}/netscli-gui-linux-x86_64.AppImage`,
-        hint: 'Any distro — chmod +x and run',
+        hint: 'Any distro. chmod +x and run',
       },
       {
         label: 'AUR (Arch)',
@@ -171,7 +171,7 @@ export const tryCommands: TryCommand[] = [
  * alternative route for every platform, which is what made it read as a wall
  * rather than a choice. */
 export const installBinariesNote =
-  'Rust users can <code>cargo install netscli</code>. Every binary and installer is checksummed and signed with <a href="https://docs.sigstore.dev/cosign/overview/">Sigstore cosign</a> — see <a href="/docs/install/#verifying-a-download">how to verify a download</a>, plus standalone binaries and packet-capture builds.';
+  'Rust users can <code>cargo install netscli</code>. Every binary and installer is checksummed and signed with <a href="https://docs.sigstore.dev/cosign/overview/">Sigstore cosign</a>. The install guide shows <a href="/docs/install/#verifying-a-download">how to verify a download</a> and lists the standalone binaries and packet-capture builds.';
 
 // Two things /llms.txt says that no page does: a build-from-source route,
 // listed after the per-platform quickstart, and any caveat a reader acting
@@ -182,6 +182,6 @@ export const installFromSource = 'cargo install netscli';
 
 export const installNotes = [
   'Packet capture is a compile-time feature. No published desktop installer',
-  'includes it; capture-enabled CLI assets are published separately and also',
+  'includes it. Capture-enabled CLI assets are published separately and also',
   'need a system capture library (libpcap or Npcap).',
 ];

site/src/data/site-content/meta.ts

@@ -6,7 +6,7 @@ export const meta: Meta = {
   // a search result shows on words nobody searches for. The interfaces are the
   // differentiator, and MCP is the one term here with real intent behind it
   // and almost no competition.
-  title: 'NetsCLI — Network Scanner for Desktop, CLI, and MCP',
+  title: 'NetsCLI | Network Scanner for Desktop, CLI, and MCP',
   // 153 characters. The previous one ran to 172 and was cut around 158, which
   // truncated the MCP mention off the end -- the most valuable word in it. It
   // also ran operations and interfaces through a single "for" series

site/src/data/site-content/surfaces.ts

@@ -3,7 +3,7 @@ import type { SectionCopy, SurfaceCard } from './types';
 export const surfacesCopy: SectionCopy = {
   heading: 'Choose how to work with your network',
   leadHtml:
-    'Four ways in, one engine behind them. Whichever you pick — desktop app, terminal UI, CLI or MCP — a port scan means the same thing and returns the same answer. <a href="/docs/">Full docs →</a>',
+    'Four ways in, one engine behind them. Whichever you pick (desktop app, terminal UI, CLI or MCP), a port scan means the same thing and returns the same answer. <a href="/docs/">Full docs →</a>',
 };
 
 export const surfaces: SurfaceCard[] = [
@@ -23,7 +23,7 @@ export const surfaces: SurfaceCard[] = [
   {
     title: 'Terminal UI',
     body:
-      'Run <code>netscli</code> with no subcommand to start the terminal UI. It is the one to reach for when you are already in a shell and want to stay there — history and autocomplete included, with local interface activity beside the results.',
+      'Run <code>netscli</code> with no subcommand to start the terminal UI. It is the one to reach for when you are already in a shell and want to stay there. History and autocomplete are included, with local interface activity beside the results.',
     image: {
       src: '/assets/tui-discover.png',
       webp: '/assets/tui-discover.webp',