Re: [openstack-dev] [openstack-sdk-php] Questions about user-facing documentation

2014-04-28 Thread Shaunak Kashyap
> We had a good discussion on IRC about some of the possible difficulties with > this domain: 1) is the developer.example.com standard commercial-based and > not open-source? and 2) will developers who want to contribute to OpenStack > be confused by this additional subdomain? For 1), I don't be

Re: [openstack-dev] [openstack-sdk-php] Questions about user-facing documentation

2014-04-28 Thread Anne Gentle
On Sun, Apr 27, 2014 at 7:57 PM, Shaunak Kashyap < shaunak.kash...@rackspace.com> wrote: > Thanks for your inputs, Matt and Anne. I'm punting on the first question > (re: publishing) for now. It sounds like this is a larger discussion and we > can make progress on the PHP SDK user-facing documenta

Re: [openstack-dev] [openstack-sdk-php] Questions about user-facing documentation

2014-04-27 Thread Shaunak Kashyap
Thanks for your inputs, Matt and Anne. I’m punting on the first question (re: publishing) for now. It sounds like this is a larger discussion and we can make progress on the PHP SDK user-facing documentation without answering it right away. I’ll bring it up again if we don’t have an answer by th

Re: [openstack-dev] [openstack-sdk-php] Questions about user-facing documentation

2014-04-21 Thread Anne Gentle
Great questions, Shaunak. Yep I've been thinking about this for a while but not sure I have complete conclusions. More below. On Wed, Apr 16, 2014 at 9:06 PM, Shaunak Kashyap < shaunak.kash...@rackspace.com> wrote: > Hi folks, > > As part of working on > https://blueprints.launchpad.net/openstac

Re: [openstack-dev] [openstack-sdk-php] Questions about user-facing documentation

2014-04-17 Thread Matthew Farina
Shaunak, these are some good questions. Input from the docs team would be useful for some of these as well. On Wed, Apr 16, 2014 at 10:06 PM, Shaunak Kashyap wrote: > Hi folks, > > As part of working on > https://blueprints.launchpad.net/openstack-sdk-php/+spec/sphinx-docs, I’ve > been looking

[openstack-dev] [openstack-sdk-php] Questions about user-facing documentation

2014-04-16 Thread Shaunak Kashyap
Hi folks, As part of working on https://blueprints.launchpad.net/openstack-sdk-php/+spec/sphinx-docs, I’ve been looking at http://git.openstack.org/cgit/stackforge/openstack-sdk-php/tree/doc. Before I start making any changes toward that BP, however, I wanted to put forth a couple of overarchi