diff --git a/guidelines/general.rst b/guidelines/general.rst new file mode 100644 index 0000000..2a25c6f --- /dev/null +++ b/guidelines/general.rst @@ -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.