Skip to content

Document plugins#2480

Merged
dmcgowan merged 2 commits intocontainerd:masterfrom
dmcgowan:proxy-plugin-doc
Jul 30, 2018
Merged

Document plugins#2480
dmcgowan merged 2 commits intocontainerd:masterfrom
dmcgowan:proxy-plugin-doc

Conversation

@dmcgowan
Copy link
Copy Markdown
Member

Add plugins documentation to root as well as mention configuring proxy and runtime plugins.

Comment thread PLUGINS.md Outdated
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

nit: s/GRPC/gRPC/g ?

@AkihiroSuda
Copy link
Copy Markdown
Member

Can we remove containerd/design/plugins.md now?

Comment thread PLUGINS.md Outdated
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

"In this case..."

@dmcgowan dmcgowan force-pushed the proxy-plugin-doc branch 2 times, most recently from c2e31e7 to 707ebdf Compare July 20, 2018 19:00
@codecov-io
Copy link
Copy Markdown

codecov-io commented Jul 20, 2018

Codecov Report

Merging #2480 into master will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@           Coverage Diff           @@
##           master    #2480   +/-   ##
=======================================
  Coverage   44.76%   44.76%           
=======================================
  Files          93       93           
  Lines        9555     9555           
=======================================
  Hits         4277     4277           
  Misses       4585     4585           
  Partials      693      693
Flag Coverage Δ
#linux 48.98% <ø> (ø) ⬆️
#windows 41.04% <ø> (ø) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update d02728f...1580ec5. Read the comment docs.

@crosbymichael
Copy link
Copy Markdown
Member

LGTM

Comment thread PLUGINS.md Outdated
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

s/users/user

Comment thread PLUGINS.md Outdated
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

nit: I would actually remove Using

Comment thread PLUGINS.md Outdated
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

without needing to recompile the daemon ?

Comment thread PLUGINS.md Outdated
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

allows extension through 2 methods:
  - via a binary available in containerd's PATH
  - by configuring containerd as a proxy to another gRPC service

?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

yeah I'll update to a format like that, I think that is clearer than a run-on sentence

Comment thread PLUGINS.md Outdated
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

may be me not being a native speaker, but which defaults to made me think that you would display the content of the file, not its location.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

That is a reasonable interpretation of the sentence, changing to which by default is at to be more clear.

Comment thread PLUGINS.md Outdated
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

s/explained/explains

Comment thread PLUGINS.md Outdated
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

s/with/using the pattern/ ?

@dmcgowan
Copy link
Copy Markdown
Member Author

@mlaventure thanks for taking a look, updated

Comment thread README.md Outdated
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

the use of proxy_plugin. is a bit confusing here maybe something like:

The string following proxy_plugin. will be used as the name?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

updated, also the defaults to

@mlaventure
Copy link
Copy Markdown
Contributor

Had one more comment, but LGTM otherwise

Copy link
Copy Markdown
Contributor

@mlaventure mlaventure left a comment

Choose a reason for hiding this comment

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

LGTM

@dmcgowan dmcgowan added this to the 1.2 milestone Jul 25, 2018
@estesp
Copy link
Copy Markdown
Member

estesp commented Jul 26, 2018

The document reads well, but the header capitalization doesn't seem to match the rest of our markdown files? I think we want initial capitals for words in headers? Pretty minor, and otherwise LGTM.

dmcgowan added 2 commits July 25, 2018 23:28
Add plugins documentation to root.
Mention configuring proxy plugins and runtime plugins.

Signed-off-by: Derek McGowan <[email protected]>
@dmcgowan dmcgowan merged commit ca71484 into containerd:master Jul 30, 2018
@dmcgowan dmcgowan deleted the proxy-plugin-doc branch September 10, 2019 17:47
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.

7 participants