Skip to content
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

Merged
merged 3 commits into from
May 2, 2018
Merged

Add docs about Node Types #471

merged 3 commits into from
May 2, 2018

Conversation

lidel
Copy link
Member

@lidel lidel commented Apr 30, 2018

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:

screenshot_2

It also adds similar link for docs/window.ipfs.md, which already existed, but was impossible to discover from Preferences screen.

Trying to answer questions raised in
#470
@lidel lidel added the UX label Apr 30, 2018
@olizilla
Copy link
Member

👓

@olizilla olizilla self-requested a review April 30, 2018 11:35
Copy link
Member

@olizilla olizilla left a 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.


![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
Copy link
Member

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

Copy link
Member

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


When in doubt, run go-ipfs as External node instead.

## (Public)
Copy link
Member

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.

@lidel lidel merged commit 0598d1f into master May 2, 2018
@lidel lidel deleted the node-types-docs branch May 2, 2018 09:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants