Re: [openstack-dev] [neutron] Purpose and documentation of the API

2015-12-02 Thread Ihar Hrachyshka
Sean M. Collins wrote: On Tue, Dec 01, 2015 at 07:16:00AM EST, Neil Jerram wrote: _What is important: the API, or documented use cases?_ Both are important - however I think I understand what you are trying to tease out. Being theoretically inclined, I tend to assume that if an API exists,

Re: [openstack-dev] [neutron] Purpose and documentation of the API

2015-12-01 Thread Sean M. Collins
On Tue, Dec 01, 2015 at 07:16:00AM EST, Neil Jerram wrote: > _What is important: the API, or documented use cases?_ Both are important - however I think I understand what you are trying to tease out. > > Being theoretically inclined, I tend to assume that if an API exists, it > is the primary th

[openstack-dev] [neutron] Purpose and documentation of the API

2015-12-01 Thread Neil Jerram
Sometimes when I'm discussing or reviewing proposed specs, I feel as though I may have incorrect assumptions about what the Neutron API is _for_. And certainly I feel that we lack good unified documentation of it - or at least, that I haven't yet found that documentation, if it exists. So I'd lik