-
Notifications
You must be signed in to change notification settings - Fork 325
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add docs about Node Types #471
Conversation
Trying to answer questions raised in #470
👓 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
That's helpful 👍 Comments are minor and at your discretion. I'm fine for this to go in as is.
docs/node-types.md
Outdated
|
||
![screenshot of node type toggle](https://user-images.githubusercontent.com/157609/39421672-59010924-4c6a-11e8-9e64-6b5d5f5f2768.png) | ||
|
||
> **TL;DR** When in doubt, run go-ipfs as External node |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I agree with the tl;dr. Add a link to https://ipfs.io/docs/getting-started/ so they have all they need!
README.md
Outdated
@@ -46,16 +46,11 @@ Websites can detect if `window.ipfs` exists and opt-in to use it instead of crea | |||
It saves system resources and battery (on mobile), avoids the overhead of peer discovery/connection, enables shared repository access and more! | |||
Make sure to read our [notes on `window.ipfs`](https://github.com/ipfs-shipyard/ipfs-companion/blob/master/docs/window.ipfs.md), where we explain it in-depth and provide examples on how to use it your own dapp. | |||
|
|||
#### Embedded `js-ipfs` Node | |||
#### Toggle Between Embedded and External Node | |||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Might be helpful to add the screenshot of the node toggle here
docs/node-types.md
Outdated
|
||
When in doubt, run go-ipfs as External node instead. | ||
|
||
## (Public) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'd leave off the brackets here. We could add a line about how it's not an option from the node toggle, as it's only used as fallback.
This PR is is trying to address onboarding issues raised in: #470 (cc @slrslr)
It adds
docs/node-types.md
doc (see doc preview) and links to it from Preferenses screen:It also adds similar link for
docs/window.ipfs.md
, which already existed, but was impossible to discover from Preferences screen.