Skip to content

Commit 8aba60f

Browse files
committed
Correct publishing, retention, and traffic guidance
1 parent fd532dc commit 8aba60f

21 files changed

Lines changed: 258 additions & 28 deletions

‎content/(concepts)/spaces.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ The substring class survives numeric suffixing, so `paypal-2` fails for the same
4848

4949
Dashboard route names are reserved too, and the reservation is scoped to the position. `settings` is refused as a Space slug and accepted as a team slug. Refused as Space slugs: `agents`, `api-keys`, `billing`, `connect`, `domains`, `drop`, `handoffs`, `members`, `new`, `partners`, `resume`, `settings`, `variables`, `webhooks`. The `422` carries a `details.suggestion` you can take as-is.
5050

51-
A retired slug stays taken. After a rename the old slug belongs to that Space forever, and anyone else asking for it gets `422` `slug_unavailable`.
51+
A rename keeps the old slug reserved for that Space. Other Spaces asking for it get `422` `slug_unavailable`.
5252

5353
Check before you commit with [`getSlugAvailability`](/api/reference/spaces/getslugavailability).
5454

‎content/(concepts)/versions.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ An explicit promote is never held by a manual policy. That hold only applies to
9696

9797
## Per-version URLs
9898

99-
Every version that reaches ready gets a permanent hostname of its own, computed once and stored:
99+
Every version that reaches ready gets a fixed hostname of its own, computed once and stored. It serves that snapshot while the version is retained:
100100

101101
```text
102102
https://my-site--v7.space.fast/

‎content/(publish)/ci.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -123,7 +123,7 @@ Every value shows up on the version, so version history says which commit and wh
123123
echo "Preview: $(jq -r '.data.version.immutableUrl' receipt.json)"
124124
```
125125

126-
`version.immutableUrl` is that version's permanent hostname, which keeps serving that exact build no matter what goes live later. `activation.outcome` comes back `unpromoted`, and promoting it later is one call to the URL in `links.promote`.
126+
`version.immutableUrl` is that version's fixed hostname. It serves that exact build while the version is retained, regardless of what goes live later. `activation.outcome` comes back `unpromoted`, and promoting it later is one call to the URL in `links.promote`.
127127

128128
A preview on an existing Space refuses `--name`, `--mode`, and a non-`auto` `--spa`, because a preview must not change settings live traffic shares.
129129

‎content/(publish)/publish.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ The parts you actually read:
154154
| `space.liveUrl` | The URL to open |
155155
| `version.id`, `version.ref`, `version.number` | The version this publish created |
156156
| `version.status` | `ready` means finalized |
157-
| `version.immutableUrl` | The permanent per-version URL, null while finalizing |
157+
| `version.immutableUrl` | The fixed URL for a retained version, null while finalizing |
158158
| `activation.outcome` | `activated`, `unpromoted`, `superseded`, or `pending` |
159159
| `next.action` | `done`, `upload`, `finalize`, or `poll` |
160160
| `next.url` | Where to go for that action |

‎content/(reference)/config-file.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ sidebar:
55
order: 1
66
---
77

8-
`sf.jsonc` is the project config Spacefast reads when a version finalizes. This page lists every key the schema accepts. After it you can write the file by hand and know which defaults are real.
8+
`sf.jsonc` is the project config Spacefast reads when a version finalizes. The reference below lists accepted keys and their defaults.
99

1010
## A full example
1111

‎content/(reference)/glossary.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ sidebar:
55
order: 3
66
---
77

8-
The terms below show up starting on the homepage and get used without re-explanation everywhere after. If a word stopped you somewhere else in these docs, it's probably here.
8+
Definitions of Spacefast terms, with links to the guides that explain them.
99

1010
## Ability
1111

‎content/(serve)/caching.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ For the browser, a publish changes nothing that needs waiting on. `max-age=0` me
101101
```
102102
</Step>
103103
<Step title="Open the version URL">
104-
Every version keeps a permanent hostname of its own, which serves that exact build regardless of what is live. See [URLs and hostnames](/urls).
104+
Each retained, ready version has a fixed hostname that serves its exact build, regardless of what is live. See [URLs and hostnames](/urls).
105105
</Step>
106106
</Steps>
107107

‎content/(serve)/stats.mdx‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -17,21 +17,21 @@ Open the Space and go to **Settings → Stats**. A segmented control labelled **
1717

1818
Thirty days is the widest window. There is no longer one.
1919

20-
The page shows two totals, **Requests** and **Views**, then three sections.
20+
The page shows **Requests**, **Visitor requests**, and **Visitors per day**. Visitor requests include assets, not only page loads. Visitors per day averages complete UTC days in the selected window.
2121

2222
| Section | What it lists |
2323
| --- | --- |
2424
| Traffic by period | One row per bucket, with requests, views, and bandwidth |
25-
| Unique visitors | Distinct visitors per day |
25+
| Visitors | Daily distinct counts in the period table. The hourly window lists daily counts under the visitor card |
2626
| Top paths | The busiest paths in the window |
2727

28-
Buckets are labelled in UTC, not your timezone, because that is the boundary the edge measured. Bandwidth is available in the table's field picker but hidden by default, since bandwidth is unlimited on every plan.
28+
Buckets are labelled in UTC. Bandwidth is available in the table's field picker but hidden by default. Delivery has [plan allowances and usage rates](/usage).
2929

3030
## What counts as a view
3131

3232
A **request** is any HTTP request the Space answered. A **view** is a request from something that is not a crawler with a status under 400, assets included. So `views` cannot exceed `requests`, and the gap comes from crawlers and responses with a status of 400 or higher.
3333

34-
**Unique visitors** come from a separate daily measurement. It ignores the crawler and status filters, and it merges every hostname mapped to the Space into one count. Daily is the finest resolution available, and days are never summed into a window total. That's why the page lists them one by one instead of showing a single number.
34+
**Unique visitors** come from a separate daily measurement. It ignores the crawler and status filters, and it merges every hostname mapped to the Space into one count. Daily is the finest resolution available, and days are never summed into a window total. The dashboard shows daily counts and an average over complete days, rather than adding daily visitors into a window total.
3535

3636
**Top paths** and top hosts are capped at 10 entries each.
3737

@@ -74,6 +74,6 @@ curl "https://api.spacefast.com/v1/spaces/spc_xxxxxxxx/analytics?window=7d" \
7474

7575
There is no window-level request total in the payload. Sum `series[].requests` for it, which is what the dashboard does.
7676

77-
## This is not Google Analytics
77+
## Add browser analytics
7878

79-
These numbers are the edge's own accounting, and they are all you get from Spacefast. If you want page-level product analytics, add your own tag. **Customization → Google Analytics** takes a GA4 measurement id or a Tag Manager container id and injects it into every published page. That is a separate feature with a separate switch. See [Customization](/customization).
79+
For browser analytics, add your own tag. **Customization → Google Analytics** takes a GA4 measurement id or a Tag Manager container id. Its own switch controls whether the tag loads. See [Customization](/customization).

‎content/(serve)/urls.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ A slug cannot contain `--`, because `--` is the separator between a version or b
2626

2727
## Version URLs
2828

29-
Every version that reaches ready gets a permanent hostname of its own:
29+
Every version that reaches ready gets a fixed hostname of its own:
3030

3131
```text
3232
https://{label}--v{number}.{apex}/

‎content/_llms-preamble.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ source named under Reference surfaces.
2323

2424
## Set up an agent
2525

26-
Any agent that can fetch a URL learns to publish from one prompt:
26+
An agent that can fetch URLs and make HTTP requests can follow this publishing guide:
2727

2828
```
2929
Fetch https://spacefast.com/setup.md

0 commit comments

Comments
 (0)