[openstack-dev] [OpenStack-docs] Neutron documentation to update about new vendor plugin, but without code in repository?

Edgar Magana edgar.magana at workday.com
Sat Oct 11 01:20:13 UTC 2014


Hi,

IMHO we should have a proper way to reference external vendor specific plugins/drivers mostly because at least in Neutron we are considering to move ALL vendor specific code out-of-tree, again it is just a consideration not a fact.

So, having a place holder for that will make sense.

Thanks,

Edgar

From: Anne Gentle <anne at openstack.org<mailto:anne at openstack.org>>
Date: Friday, October 10, 2014 at 12:18 PM
To: "OpenStack-dev at lists.openstack.org<mailto:OpenStack-dev at lists.openstack.org>" <OpenStack-dev at lists.openstack.org<mailto:OpenStack-dev at lists.openstack.org>>
Cc: "openstack-docs at lists.openstack.org<mailto:openstack-docs at lists.openstack.org>" <openstack-docs at lists.openstack.org<mailto:openstack-docs at lists.openstack.org>>
Subject: Re: [OpenStack-docs] [openstack-dev] Neutron documentation to update about new vendor plugin, but without code in repository?



On Fri, Oct 10, 2014 at 2:11 PM, Vadivel Poonathan <vadivel.openstack at gmail.com<mailto:vadivel.openstack at gmail.com>> wrote:

Hi,

How to include a new vendor plug-in (aka mechanism_driver in ML2 framework) into the Openstack documentation?.. In other words, is it possible to include a new plug-in in the Openstack documentation page without having the actual plug-in code as part of the Openstack neutron repository?... The actual plug-in is posted and available for the public to download as Ubuntu package. But i need to mention somewhere in the Openstack documentation that this new plugin is available for the public to use along with its documentation.

We definitely want you to include pointers to vendor documentation in the OpenStack docs, but I'd prefer make sure they're gate tested before they get listed on docs.openstack.org<http://docs.openstack.org>. Drivers change enough release-to-release that it's difficult to keep up maintenance.

Lately I've been talking to driver contributors (hypervisor, storage, networking) about the out-of-tree changes possible. I'd like to encourage even out-of-tree drivers to get listed, but to store their main documents outside of docs.openstack.org<http://docs.openstack.org>, if they are gate-tested.

Anyone have other ideas here?

Looping in the OpenStack-docs mailing list also.
Anne



Pls. provide some insights into whether it is possible?.. and any further info on this?..

Thanks,

Vad

--

_______________________________________________
OpenStack-dev mailing list
OpenStack-dev at lists.openstack.org<mailto:OpenStack-dev at lists.openstack.org>
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20141011/b8b12392/attachment.html>


More information about the OpenStack-dev mailing list