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 documentation

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

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

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

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 shaunak.kash...@rackspace.com wrote: Hi folks, As part of working on

[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