Open Stack

On Sat, Mar 28, 2015 at 5:29 PM, Christian Berendt <christian at berendt.io>
wrote:

> On 03/28/2015 05:00 PM, Anne Gentle wrote:
>
>> Does that sound like a good way forward? Our main goal is to enable
>> contributions and provide great information while doing so. So, our
>> priority will be enabling others with great tooling, great structures.
>>
>
> We can do this, yes. But the CLI guide is fully autogenerated and it is no
> work to add and update the documents. I would prefer to simply add the new
> clients to the CLI guide, I can take care.
>
>
Yes, but then you're taking away a fairly small task that could get someone
started with docs who hasn't contributed before. They'd get to know us as
reviewers and perhaps be interested in contributing more.

I know I don't have much sway in what you work on, of course! Just think
about it a bit more. I see the automation patches (CLI, Config Ref) as a
way to grow more contributors and reviewers through these types of
low-hanging-fruit doc tasks.


> I regular have a look at http://ghostcloud.net/openstack_client.html if
> there was an update of a CLI client and I added my script to update the
> files at https://github.com/openstack/openstack-doc-tools/blob/
> master/bin/doc-tools-update-cli-reference.



I like this! Super cool site Christian. The gerrit dashboards alone are a
huge find! Thank you!

Anne


>
>
> Christian.
>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>



-- 
Anne Gentle
annegentle at justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20150328/132acf08/attachment.html>