Skip to content

Commit c3bcc50

Browse files
committed
Stop describing Spacefast with the word hosting
1 parent e84d3ee commit c3bcc50

8 files changed

Lines changed: 38 additions & 19 deletions

File tree

‎.vale.ini‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,3 +30,18 @@ Spacefast.Hype = NO
3030
Spacefast.Wordiness = NO
3131
Spacefast.Condescension = NO
3232
Spacefast.ApiKey = NO
33+
Spacefast.Hosting = NO
34+
35+
; Generated error pages are a verified snapshot synced from the monorepo, and
36+
; the OpenAPI prose extraction reads generated/openapi. Both stay exempt from
37+
; the "hosting" rule until the snapshot is refreshed with the monorepo fixes;
38+
; then remove these carve-outs.
39+
[content/(reference)/errors/**]
40+
BasedOnStyles = Vale, Spacefast
41+
Vale.Spelling = NO
42+
Spacefast.Hosting = NO
43+
44+
[*openapi-prose.md]
45+
BasedOnStyles = Vale, Spacefast
46+
Vale.Spelling = NO
47+
Spacefast.Hosting = NO

‎AGENTS.md‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -89,8 +89,11 @@ alerts is the bar.
8989
rules, which mirror the vocabulary registry in the product monorepo
9090
(`packages/common/src/vocabulary.ts`): "API key" never "access token". The
9191
infra brand is "WP Cloud" (never dotted or hyphenated). Prefer "infra";
92-
name WP Cloud only when the external reference is necessary — never the
93-
euphemism "the hosting provider". Marketing may use the family line "the
92+
name WP Cloud only when the external reference is necessary. Never use the
93+
word "hosting" in prose: say publish, serve, live, infrastructure, or
94+
runtime (`Hosting.yml`). Generated error pages, OpenAPI prose, and the
95+
shipped changelog are exempt until the generated snapshot is refreshed.
96+
Marketing may use the family line "the
9497
same infra as Automattic, WP Cloud, Pressable, and WordPress.com".
9598
- Unknown technical words go in `styles/Spacefast/spelling-exceptions.txt`
9699
(sorted, case matters for proper nouns). Identifiers in prose — commands,

‎STYLE_GUIDE.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -211,9 +211,9 @@ that is.
211211
(`ProductName.yml`).
212212
- **WP Cloud** — exact casing, never "wp cloud," "wp.cloud," or hyphenated
213213
(`WpCloudBrand.yml`). Prefer "infra" generally; name WP Cloud only when
214-
the external reference is genuinely necessary. Never say "the hosting
215-
provider" for Spacefast's own infra (`HostingProvider.yml`) — generic
216-
references to *other* hosting providers are fine.
214+
the external reference is genuinely necessary. Never use the word
215+
"hosting" for Spacefast or its features (`Hosting.yml`). Say publish,
216+
serve, live, infrastructure, or runtime.
217217
- **"API key," never "access token"** (`ApiKey.yml`) — "OAuth access
218218
token" is the one exempted phrase, since that's the protocol's own term.
219219

‎content/(serve)/domains.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -237,7 +237,7 @@ www.example.com purpose=www dns=not_configured txt=missing ssl=missing
237237

238238
### Checking before you commit
239239

240-
`GET /v1/domains/preflight?name=example.com` runs the same name validation and hosting check as the add, so terminal problems surface before any record exists. Its `canHost` verdict is advisory. A `false` still lets you add the domain and claim it with the TXT proof, and `null` means the check was unavailable rather than negative.
240+
`GET /v1/domains/preflight?name=example.com` runs the same name validation and serving check as the add, so terminal problems surface before any record exists. Its `canHost` verdict is advisory. A `false` still lets you add the domain and claim it with the TXT proof, and `null` means the check was unavailable rather than negative.
241241

242242
## Next steps
243243

‎content/api/errors.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -180,8 +180,8 @@ Two retry rules that come from the wire rather than the table. A `429` carries `
180180
| `internal_error` | retry | yes | Something went wrong on our side. |
181181
| `maintenance_in_progress` | wait | yes | This change is temporarily unavailable while maintenance finishes. |
182182
| `provider_error` | retry | yes | Spacefast could not complete the operation. |
183-
| `provider_job_failed` | retry | yes | A hosting-provider job failed while processing this operation. |
184-
| `provider_job_timeout` | retry | yes | A hosting-provider job timed out while processing this operation. |
183+
| `provider_job_failed` | retry | yes | A provider job failed while processing this operation. |
184+
| `provider_job_timeout` | retry | yes | A provider job timed out while processing this operation. |
185185
| `space_disabled` | fix_input | no | The space is disabled and cannot be served or modified. |
186186

187187
## Every error code

‎content/platforms/partner-api/configuration.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Add a `system` block to the system Space's `sf.jsonc`. Keep the other project se
2727
{
2828
"system": {
2929
"presentation": {
30-
"name": "Example Hosting",
30+
"name": "Example Cloud",
3131
"logo": "https://example.com/logo.png",
3232
"supportUrl": "https://example.com/support",
3333
"claimOrigin": "https://portal.example.com",

‎styles/Spacefast/Hosting.yml‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Ruling 2026-11-11: never define or describe Spacefast with the word
2+
# "hosting". Say publish, serve, live, infrastructure, or runtime instead.
3+
# Narrow uses about something else (a third-party product) are rare; rephrase
4+
# first, and only suppress a line with an inline Vale comment when it is truly
5+
# about something other than Spacefast.
6+
extends: existence
7+
message: "Don't use '%s' to describe Spacefast. Say publish, serve, live, infrastructure, or runtime."
8+
level: error
9+
ignorecase: true
10+
tokens:
11+
- hosting

‎styles/Spacefast/HostingProvider.yml‎

Lines changed: 0 additions & 10 deletions
This file was deleted.

0 commit comments

Comments
 (0)