api-sig/guidelines/terms.rst
Chris Yeoh e00144c3a0 Moves from markdown to rst
Changes format of files from markdown to reStructuredText
and adds the tox targets to verify the format and build
the html. Also adds bits and pieces needed to finish
bootstrapping the repository.

Change-Id: If559c21f19d7044a0d89b29e5743bf09c9da2ac1
2014-10-22 16:24:41 +10:30

28 lines
1.0 KiB
ReStructuredText

Terms
=====
As Phil Karlson [once said](http://martinfowler.com/bliki/TwoHardThings.html):
> There are only two hard things in Computer Science: cache invalidation and
> naming things.
Over time, various terms and synonyms for those terms generate some
controversy, and different teams end up using different words to reference the
same object or resource. This document serves to record decisions that were
made regarding certain terms, and attempts to succinctly define each term.
* **project** vs. **tenant**
**project** shall be used to describe the concept of a group of OpenStack
users that share a common set of quotas. The older term **tenant** should
*not* be used in OpenStack REST APIs.
* **server** vs. **instance**
**server** shall be used to describe a virtual machine, a
bare-metal machine, or a containerized virtual machine that is used
by OpenStack users for compute purposes. The older term
**instance** that is also by Amazon Web Services EC2 API to
describe a virtual machine, should *not* be used in OpenStack REST
APIs.