marketplace: write instructions for transitioning #447
Conversation
✅ Deploy Preview for grist-help-preview ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
jordigh
force-pushed
the
jordigh/omnibus-transition
branch
5 times, most recently
from
db88f64 to
cfc3223
Compare
There was a problem hiding this comment.
With a few more details to help the user's mental model in case of problems (and there are always problems), this is close to fine. I was hoping for instructions that would help with transitioning any single-server setup, with some extra notes for AWS-specific steps, but maybe there isn't enough to say.
The main thing I'd like to see fleshed out is to systematically clue the user in on the default email wrinkle. It is dangerous and confusing to be setting up Grist without knowing what that is about. Feels like it merits a section in the self-managed handbook, rather than a very passing mention in telemetry which is all I see right now? https://support.getgrist.com/self-managed/#how-do-i-control-telemetry
It would be super helpful if you told users that this email will control access to the single team site that gets created for them on first run, and the consequences and symptoms of changing it. And that'll be valuable not only for AWS users but lots of other people.
jordigh
force-pushed
the
jordigh/omnibus-transition
branch
2 times, most recently
from
5e730c2 to
6f2e8de
Compare
| * The entire `~/grist-persist/docs` directory | ||
|
|
||
| Also see ["What files does Grist | ||
| store?"](../../self-managed#what-files-does-grist-storex) for an |
| The traditional method to copy files across instances is `scp`, a file | ||
| transfer mechanism over the SSH protocol. A small complication is that | ||
| the user to copy to, `grist` in the target EC2 instance, by default | ||
| does not have ssh login enabled. We recommend copying into the default |
There was a problem hiding this comment.
"an SSH login" or "an ssh login"?
jordigh
force-pushed
the
jordigh/omnibus-transition
branch
from
6f2e8de to
8b2b801
Compare
There are very few users who should ever need to do this, so the instructions are a little sparse on details. I believe this to be an acceptable compromise.