<div dir="ltr">Hi Mike,<div><br></div><div>All of the items look nice. I have a small comment regarding to the docs.</div><div>I don't think that we should force plugin developer to write the docs in</div><div>Sphinx compatible format, I vote for Github compatible docs format,</div><div>and in case if we want to show this information somewhere else,</div><div>we can use Github's engine [1] to convert the docs into html pages.</div><div><br></div><div>Thanks,</div><div><br></div><div>[1] <a href="https://github.com/github/markup/tree/master">https://github.com/github/markup/tree/master</a></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Jan 23, 2015 at 1:25 AM, Mike Scherbakov <span dir="ltr"><<a href="mailto:mscherbakov@mirantis.com" target="_blank">mscherbakov@mirantis.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Hi Fuelers,<div>we've implemented pluggable architecture piece in 6.0, and got a number of plugins already. Overall development process for plugins is still not fully defined.</div><div>We initially thought that having all the plugins in one repo on stackforge is Ok, we also put some docs into existing fuel-docs repo, and specs to fuel-specs.<br clear="all"><div><br></div><div>We might need a change here. Plugins are not tight to any particular release date, and they can also be separated each from other in terms of committers and core reviewers. Also, it seems to be pretty natural to keep all docs and design specs associated with particular plugin.</div><div><br></div><div>With all said, following best dev practices, it is suggested to:</div><div><ol><li>Have a separate stackforge repo per Fuel plugin in format "fuel-plugin-<name>", with separate core-reviewers group which should have plugin contributor initially</li><li>Have docs folder in the plugin, and ability to build docs out of it</li><ul><li>do we want Sphinx or simple Github docs format is Ok? So people can just go to github/stackforge to see docs</li></ul><li>Have specification in the plugin repo</li><ul><li>also, do we need Sphinx here?</li></ul><li>Have plugins tests in the repo</li></ol></div><div>Ideas / suggestions / comments?</div><div>Thanks,</div><span class="HOEnZb"><font color="#888888">-- <br><div><div dir="ltr">Mike Scherbakov<br>#mihgen<br><br></div></div>
</font></span></div></div>
<br>__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br></blockquote></div><br></div>