<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<style type="text/css" style="display:none"><!-- p { margin-top: 0px; margin-bottom: 0px; }--></style>
</head>
<body 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 style="color: rgb(33, 33, 33);">
<hr tabindex="-1" style="display:inline-block; width:98%">
<div id="divRplyFwdMsg" dir="ltr"><font face="Calibri, sans-serif" color="#000000" style="font-size:11pt"><b>From:</b> Anne Gentle <annegentle@justwriteclick.com><br>
<b>Sent:</b> Tuesday, May 24, 2016 09:07<br>
<b>To:</b> openstack-docs@lists.openstack.org; Everett Toews; Brian Curtin<br>
<b>Subject:</b> [user-guide] Python SDK examples</font>
<div> </div>
</div>
<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">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">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">
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">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">http://docs.openstack.org/user-guide/sdk_authenticate_against_identity_endpoint.html</a><br>
-- <br>
Anne Gentle<br>
<a href="http://www.justwriteclick.com">www.justwriteclick.com</a></div>
</div>
</div>
</div>
</div>
</body>
</html>