openstack/api-sig
Code Issues Proposed changes
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

1.0 KiB
Raw Blame History

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.