Re: [openstack-dev] [Neutron] Developer documentation - linking to slideshares?
My slides are also available to be used. On Thu, Feb 6, 2014 at 2:27 AM, Collins, Sean sean_colli...@cable.comcast.com wrote: On Tue, Feb 04, 2014 at 07:52:22AM -0600, Anne Gentle wrote: Currently the docs contributor sign the same CLA as code contributors. I'd encourage you to use the docs to really explain not just link to slide decks. There's a better chance of maintenance over time. Agreed - I plan on writing up docs, but when I find something really good on a slide I'd like to be able to have a reference to it in the footnotes - I suppose a works cited section, so I'm not plagiarizing. I had been using a wiki page for a collection of videos at https://wiki.openstack.org/wiki/Demo_Videos. But it ages with time. Awesome - I'll make sure to add that link to some kind of further reading section. -- Sean M. Collins ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
Re: [openstack-dev] [Neutron] Developer documentation - linking to slideshares?
On Tue, Feb 04, 2014 at 07:52:22AM -0600, Anne Gentle wrote: Currently the docs contributor sign the same CLA as code contributors. I'd encourage you to use the docs to really explain not just link to slide decks. There's a better chance of maintenance over time. Agreed - I plan on writing up docs, but when I find something really good on a slide I'd like to be able to have a reference to it in the footnotes - I suppose a works cited section, so I'm not plagiarizing. I had been using a wiki page for a collection of videos at https://wiki.openstack.org/wiki/Demo_Videos. But it ages with time. Awesome - I'll make sure to add that link to some kind of further reading section. -- Sean M. Collins ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
Re: [openstack-dev] [Neutron] Developer documentation - linking to slideshares?
Sean, You surely have my permission. If it's publicly available you should not even ask for it! Well, unless it's copyrighted, but at least I could not possibly copyright material mostly stolen from other people ;) On the other hand the issue with slideshare and such is that material might come and go, thus causing us to have broken links. Also, as a reader I would prefer to see everything in one place. Therefore I'd suggest to create blueprints for ovs debugging and plugin development, and then have people working on them in the framework of neutron developer docs. Salvatore On 4 February 2014 03:33, Collins, Sean sean_colli...@cable.comcast.comwrote: Hi, Some Neutron developers have some really great slides from some of the summits, and I'd like to link them in the documentation I am building as part of a developer doc blueprint, with proper attribution. https://blueprints.launchpad.net/neutron/+spec/developer-documentation I'm hoping to add Salvatore Orlando's slides on building a plugin from scratch, as well as Yong Sheng Gong's deep dive slides as references in the documentation. First - do I have permission from the previously mentioned? Second - is there any licensing that would make things complicated? As I add more links, I will make sure to ask for permission on the mailing list. Also, if you have done a presentation and have slides that help explain the internals of Neutron, I would love to add it as a reference. --- Sean M. Collins ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
Re: [openstack-dev] [Neutron] Developer documentation - linking to slideshares?
On Mon, Feb 3, 2014 at 8:33 PM, Collins, Sean sean_colli...@cable.comcast.com wrote: Hi, Some Neutron developers have some really great slides from some of the summits, and I'd like to link them in the documentation I am building as part of a developer doc blueprint, with proper attribution. https://blueprints.launchpad.net/neutron/+spec/developer-documentation I'm hoping to add Salvatore Orlando's slides on building a plugin from scratch, as well as Yong Sheng Gong's deep dive slides as references in the documentation. First - do I have permission from the previously mentioned? Second - is there any licensing that would make things complicated? Currently the docs contributor sign the same CLA as code contributors. I'd encourage you to use the docs to really explain not just link to slide decks. There's a better chance of maintenance over time. I had been using a wiki page for a collection of videos at https://wiki.openstack.org/wiki/Demo_Videos. But it ages with time. Thanks for asking - Anne As I add more links, I will make sure to ask for permission on the mailing list. Also, if you have done a presentation and have slides that help explain the internals of Neutron, I would love to add it as a reference. --- Sean M. Collins ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
[openstack-dev] [Neutron] Developer documentation - linking to slideshares?
Hi, Some Neutron developers have some really great slides from some of the summits, and I'd like to link them in the documentation I am building as part of a developer doc blueprint, with proper attribution. https://blueprints.launchpad.net/neutron/+spec/developer-documentation I'm hoping to add Salvatore Orlando's slides on building a plugin from scratch, as well as Yong Sheng Gong's deep dive slides as references in the documentation. First - do I have permission from the previously mentioned? Second - is there any licensing that would make things complicated? As I add more links, I will make sure to ask for permission on the mailing list. Also, if you have done a presentation and have slides that help explain the internals of Neutron, I would love to add it as a reference. --- Sean M. Collins ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev