openstack/api-sig
Code Issues Proposed changes

Merge "Add a "general" section"

Browse Source
This commit is contained in:
Jenkins 2015-02-20 13:56:24 +00:00 committed by Gerrit Code Review
commit a1ceb34135
1 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
guidelines/general.rst Normal file
View File

@ -0,0 +1,16 @@
General
=======
This topic document serves to provide guidance on general topics of
style and approaches to developing and managing public HTTP APIs.
Guidelines
----------
1. While every public API should have a canonical client
implementation we should discourage tight bindings between an API
and its clients and strongly encourage separate evolution of
the API and its official client. We welcome any effort aimed at
developing and promoting alternative clients. A diversity of
implementations is healthy and enables use in many environments.