Skip to content

Commit 2e5cc3f

Browse files
agviegasclaude
andcommitted
docs: stop asking which environment, everyone is on production
Second thing the real run found, and this one I caused fixing the first. Making the assistant report the environment turned into making it ask, and "production or dev?" is a decision nobody outside the platform team has ever made. It arrives as the very first question, from an assistant that is supposed to be guiding, about a distinction the user has no way to evaluate. Production is the answer. The plain `thatopen login --token <TOKEN>` is already correct, and the guide now says not to ask. Dev is folded away behind a details block for the people building the platform, who know who they are and will say so unprompted. What survives is the part that was actually useful: read `apiUrl` rather than trusting a "Logged in successfully" that never names the environment — and then say nothing when it reads production, because there is no decision to report. Only a machine unexpectedly pointed at dev is worth a sentence. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent fd60ec4 commit 2e5cc3f

2 files changed

Lines changed: 41 additions & 25 deletions

File tree

docs/platform-token.md

Lines changed: 32 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -26,36 +26,48 @@ a `.thatopen` file in the project instead, which is what a scaffolded project us
2626
You do not need an npm account or an npm token for the private packages. The CLI derives access to
2727
them from this one.
2828

29-
## Production and dev are separate worlds
29+
## Everyone is on production
30+
31+
**Do not ask the user which environment they want.** Production is the answer, it is the default,
32+
and the plain command above is already correct. Asking turns a decision nobody has into a question
33+
they cannot answer, at the worst possible moment — the first thing you say to them.
34+
35+
There is a `dev` platform, and it exists for the people building That Open Platform itself. If the
36+
user is one of them they already know, and they will tell you without being asked.
37+
38+
Everything below this line is for that case only. If nothing has mentioned dev, skip it.
39+
40+
<details>
41+
<summary>Dev, for the platform team</summary>
3042

3143
Two platforms, not two views of one. Separate accounts, separate tokens, separate projects. A token
32-
from one is refused by the other, and a model published to the wrong one is somewhere the user's
44+
from one is refused by the other, and a model published to the wrong one lands somewhere the user's
3345
team cannot see — while every command reports success.
3446

35-
| | |
36-
|---|---|
37-
| **Production** | `https://platform.thatopen.com` — the default, and what almost everybody wants |
38-
| **Dev** | `https://dev.platform.thatopen.com` — only if the user's team works there |
39-
4047
```bash
41-
thatopen login --token <TOKEN> # production
42-
thatopen login --token <TOKEN> --api-url https://dev.platform.thatopen.com # dev
48+
thatopen login --token <TOKEN> --api-url https://dev.platform.thatopen.com
4349
```
4450

45-
The dashboard for dev is the same page on that host:
46-
`https://dev.platform.thatopen.com/dashboard/data`.
51+
Its dashboard is the same page on that host: `https://dev.platform.thatopen.com/dashboard/data`.
52+
53+
</details>
54+
55+
## Check, do not ask
56+
57+
**`login` prints "Logged in successfully" and does not name the environment**, so nothing on screen
58+
would contradict a wrong assumption. Read `apiUrl` from `~/.thatopen/config.json` yourself.
59+
60+
If it says production — which it will — say nothing about it and carry on. There is no decision to
61+
report.
4762

48-
## Say which one you are on
63+
**Only if it says dev**, and the user has not told you they work there, is there anything to say:
4964

50-
**`login` prints "Logged in successfully" and does not name the environment.** Nothing on screen
51-
will contradict a wrong assumption, so make the statement yourself: read `apiUrl` from
52-
`~/.thatopen/config.json` and tell the user in plain words — *"you are on production"* or *"you are
53-
on dev"*.
65+
> "This machine is pointed at the dev platform, which is the one the That Open team builds on. I'll
66+
> move it to production — that will need a token from **https://platform.thatopen.com/dashboard/data**,
67+
> since dev tokens are not accepted there."
5468
55-
Do this **even when the machine is already logged in**, and especially then. A saved login is
56-
whoever used this machine last, not an answer to a question you have asked. If you find dev, offer
57-
production before going any further; moving needs a **production** token, so the user has to create
58-
one on the production dashboard first.
69+
Check this **even when the machine is already logged in**, and especially then. A saved login is
70+
whoever used this machine last, not an answer to a question you have asked.
5971

6072
## When it fails
6173

docs/revit-collab-quickstart.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -104,12 +104,16 @@ Do **not** ask for the access token yet. That is Step 1.
104104
thatopen login --token <TOKEN>
105105
```
106106

107-
**Read [Logging in to That Open Platform](./platform-token.md) before you run that** — it is
108-
short, and it covers the two things that go wrong here rather than later: production and dev are
109-
separate worlds, and `login` does not tell you which one you just saved.
107+
That command is already right: **it logs in to production, which is where everybody is.** Do not
108+
ask the user to choose an environment — there is a dev platform, it is for the people building
109+
That Open Platform, and they will say so without being asked.
110110

111-
In particular: **log in even if the machine is already logged in**, and say out loud which
112-
environment you ended up on. Never print the token back.
111+
**Log in even if the machine is already logged in.** A saved login is whoever used this machine
112+
last. Never print the token back.
113+
114+
[Logging in to That Open Platform](./platform-token.md) is the short page for when this does not
115+
go smoothly: what to do if the machine turns out to be pointed at dev, and why `Unauthorized` and
116+
`403` mean different things.
113117

114118
**Log in before Step 2**, not after: installing the add-in downloads a private package and needs
115119
these credentials.

0 commit comments

Comments
 (0)