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

docs: Add some docs on plugins #4255

Merged
merged 2 commits into from
Oct 9, 2017
Merged

docs: Add some docs on plugins #4255

merged 2 commits into from
Oct 9, 2017

Conversation

magik6k
Copy link
Member

@magik6k magik6k commented Sep 20, 2017

Closes #4243

Copy link
Member

@Stebalien Stebalien left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for putting this together!

docs/plugins.md Outdated
### Plugin types

#### IPLD
IPLD plugins add support for additional LD formats to `ipfs dag` and other IPLD
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/additional LD/additional IPLD/. We don't support other LD formats (JSON-LD etc...).

docs/plugins.md Outdated

Since 0.4.11 go-ipfs has a plugin system for various added functionality.

When IPFS node is created, it will load plugins from `.ipfs/plugins` directory.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To be precise, this should probably say "will load plugins from $IPFS_PATH/plugins (where $IPFS_PATH defaults to ~/.ipfs)" or something like that.

docs/plugins.md Outdated
@@ -0,0 +1,33 @@
# Plugins

Since 0.4.11 go-ipfs has a plugin system for various added functionality.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should also note that this only works on Linux.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also, we should explicitly state that this is "experimental".

@magik6k
Copy link
Member Author

magik6k commented Sep 21, 2017

Updated with section on preload

@ghost
Copy link

ghost commented Sep 21, 2017

Cool thanks, this looks good! Could you also:

  • add it to experimental-features.md
  • link it in the plugins section in the v0.4.11 changlog

docs/plugins.md Outdated
```bash
go-ipfs$ mkdir -p ~/.ipfs/plugins/
go-ipfs$ cp plugin/plugins/git.so ~/.ipfs/plugins/
```
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would add a step that checks if plugins have executable permission set.

magik6k and others added 2 commits October 5, 2017 02:18
License: MIT
Signed-off-by: Łukasz Magiera <[email protected]>
License: MIT
Signed-off-by: Jeromy <[email protected]>
@magik6k
Copy link
Member Author

magik6k commented Oct 5, 2017

LGTM

@whyrusleeping whyrusleeping merged commit 4f478e2 into master Oct 9, 2017
@whyrusleeping whyrusleeping deleted the docs/plugin branch October 9, 2017 13:55
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.

4 participants