<div dir="ltr"><div><div><div>+1 to working towards a REST API alpha overall. I am happy enough with 
the URLs structure. FYI I think the status API is missing from there 
maybe.<br><br>Is it possible for us to get the API docs auto generating and posted online in the nightly docs? That way as we continue to change them, the nightly docs will always be up to date. I remember this effort being started but I'm not sure where we are at with it. Do we have redmine tasks for this?<br><br></div>Also for the browsable docs that you get on a Pulp3 installation, is it documented how to configure Pulp so that you have browsable API docs?<br><br></div><div>I think we should have a quickstart guide that is short because it would link to the pulp_example instructions [0] which are a good user facing set of instructions. We could put the quickstart page as a top level page in the docs even though it would be mostly used to send traffic to the pulp_example instructions.<br><br>[0]: <a href="https://github.com/pulp/pulp_example/blob/master/README.rst#create-a-repository-foo">https://github.com/pulp/pulp_example/blob/master/README.rst#create-a-repository-foo</a><br></div><br></div>-Brian<br><div><div><div><br><br></div></div></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Oct 5, 2017 at 12:49 PM, Austin Macdonald <span dir="ltr"><<a href="mailto:austin@redhat.com" target="_blank">austin@redhat.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"><div>I think we are ready to start considering an alpha for our REST API. (REST API and plugin API are versioned separately.) I've started a list of all our endpoints along with accepted methods and the expected responses. I hope this list will be useful for QE as well.</div><div><br></div><div><a href="http://pad-katello.rhcloud.com/p/pulp3_REST_API" target="_blank">http://pad-katello.rhcloud.<wbr>com/p/pulp3_REST_API</a><br></div><div><br></div><div>The questions that I have:<br></div><div><ol><li>Which other endpoints do we need to add before an alpha of the REST API? (Publications?)</li><li>Are we happy with the general structure?</li><li>What else should we do before we call it an alpha?</li></ol></div></div>
</blockquote></div><br></div>