Radish alpha
r
rad:z4D5UCArafTzTQpDZNQRuqswh3ury
Radicle desktop app
Radicle
Git
Improve new repo creation on 1st launch
Closed { reason: Other } did:key:z6MkfgZK...5YMm opened 1 year ago onboarding

We should add that the repo you create is private: Create a new private repo initialized with Radicle.

And a couple notes on the hint on the side:

  • the title ‘Did you know’ sounds a little like its from a kids book, I suggest we change it to Node storage vs working copy or How it works
  • I wonder if we need to say Radicle storage like its a product, or if we say your node’s storage is easier to understand. I’d consider a more compact version like this: The private repository you create will only be stored in your node’s storage as a bare Git repository. ~~Check it out to create a working copy!~~ Create a checkout to your machine to start working with your new repo.
  • Maybe offer a checkout command as a next hint once we created the repo?
  • Slight suggestion for the last senctence: Want to learn more about how Radicle’s storage works, and how it’s different from a regular Git working copy? 
Check out the protocol guide Same queestion, we should decide how we refer to the storage: Radicle Storage, Radicle’s storage, Node storage, Your node's storage
rudolfs commented 1 year ago

All of the suggestions make sense, except for this part: “Check it out to create a working copy!”. You make a checkout of a Radicle repo from the node’s storage. To me “Check it out to create a working copy!” suggests the user should look at the node’s storage to somehow make a working copy.

z6MkfgZK...5YMm commented 1 year ago

Fair. How about Create a checkout to your machine to start working with your new repo.

rudolfs commented 1 year ago

The node’s storage already lives on your machine, so the part that says “checkout to your machine”, is somehow either redundant or implying that the storage lives somewhere else, which isn’t true.

What if instead we said this:

The private repository you create will only be stored in your node’s storage as a bare Git repository. Create a checkout to start working with your new repo. rad checkout rad:z4D5UCArafTzTQpDZNQRuqswh3ury

And at some later point we can change the checkout command to a button that let’s you pick the location and performs the checkout for you.

z6MkkfM3...sVz5 commented 1 year ago
z6MkkfM3...sVz5 commented 1 year ago

I think everything looks fine here, the only thing I would change is to keep calling it the Radicle Storage or maybe Radicle's local storage instead of node storage. Mostly due to the storage not necessarily being related to the node..

There is a good section in the user guide explaining things

Note that social artifacts are not stored in your working copy. They are stored in the associate bare repository as part of Radicle’s local storage. Read more about Radicle storage in the Protocol Guide.

I wrote a small patch here 8f076bbd that provides a checkout button to get the repo from the storage to a folder of your choosing.

rudolfs commented 10 months ago

We changed the onboarding experience, this isn’t relevant anymore.