<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, May 24, 2016 at 8:37 AM, Brian Curtin <span dir="ltr"><<a href="mailto:brian.curtin@rackspace.com" target="_blank">brian.curtin@rackspace.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr" style="font-size:12pt;color:#000000;background-color:#ffffff;font-family:Calibri,Arial,Helvetica,sans-serif">
<p>OpenStackClient would be for command-line guides, but OpenStack SDK could be used for code examples. I'm not really sure what documentation OSC has out there, but SDK has a start on per-service guides so we're pretty good there.<br>
</p>
<p><br>
</p>
<p>In general: I don't work on OpenStackClient so I can't answer for them.<br>
</p>
<p><br></p></div></blockquote><div>Augh, so sorry. Totally mistyped openstackclient when I meant openstacksdk. Sorry about that. Thanks for the quick response.</div><div><br></div><div>So, if your per-service guides are good, then maybe it's better to delete these examples than to add to content technical debt. Does anyone have opinions here? On the user-committee list we're also talking about redesigning the landing page, perhaps we'll get some discussion on how to enable more SDK examples.</div><div><br></div><div>Thanks,</div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr" style="font-size:12pt;color:#000000;background-color:#ffffff;font-family:Calibri,Arial,Helvetica,sans-serif"><p>
</p>
<div style="color:rgb(33,33,33)">
<hr style="display:inline-block;width:98%">
<div dir="ltr"><font face="Calibri, sans-serif" color="#000000" style="font-size:11pt"><b>From:</b> Anne Gentle <<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>><br>
<b>Sent:</b> Tuesday, May 24, 2016 09:07<br>
<b>To:</b> <a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.openstack.org</a>; Everett Toews; Brian Curtin<br>
<b>Subject:</b> [user-guide] Python SDK examples</font>
<div> </div>
</div><div><div class="h5">
<div>
<div dir="ltr">Hi all, <br>
<br>
I want to follow up on a question from the docs meeting about the Python SDK examples that were in the User Guide. This spec [1] indicated they should be moved to
<a href="http://developer.openstack.org" target="_blank">developer.openstack.org</a>, but doesn't indicate which guide they could become a part of or if it should be a standalone guide. I looked at the examples and they are from the novaclient, keystoneclient, neutronclient,
and so on. Example code at [2]. While it's nice to centrally locate this info, it might be better to rewrite the examples to use openstackclient.
<br>
<br>
I think it's correct to move the content to api-site, though I'd like someone to determine if the files can fit into the API Quick Start (perhaps with a title change) or as a standalone guide.
<br>
<br>
Also, should someone revise the examples to use openstackclient? If so, then would it make sense to patch the python-openstackclient repo? [3] Copying Brian and Everett to see if they have opinions. Output is here [4] for easier readability.<br>
<br>
Thanks,
<div>Anne<br>
<br>
1. <a href="http://specs.openstack.org/openstack/docs-specs/specs/mitaka/user-guides-mitaka-reorg.html" target="_blank">http://specs.openstack.org/openstack/docs-specs/specs/mitaka/user-guides-mitaka-reorg.html</a><br>
2. <a href="http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/user-guide/source/sdk_authenticate_against_networking_endpoint.rst" target="_blank">
http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/user-guide/source/sdk_authenticate_against_networking_endpoint.rst</a><br>
3. <a href="http://git.openstack.org/cgit/openstack/python-openstackclient" target="_blank">http://git.openstack.org/cgit/openstack/python-openstackclient</a>
<div>4. <a href="http://docs.openstack.org/user-guide/sdk_authenticate_against_identity_endpoint.html" target="_blank">http://docs.openstack.org/user-guide/sdk_authenticate_against_identity_endpoint.html</a><br>
-- <br>
Anne Gentle<br>
<a href="http://www.justwriteclick.com" target="_blank">www.justwriteclick.com</a></div>
</div>
</div>
</div>
</div></div></div>
</div>
</blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Anne Gentle</div><div><a href="http://www.justwriteclick.com" style="font-size:12.8px" target="_blank">www.justwriteclick.com</a><br></div></div></div></div></div>
</div></div>