diff --git a/guide/english/rest-api/index.md b/guide/english/rest-api/index.md index 141dba34b4..9c5359e6a7 100644 --- a/guide/english/rest-api/index.md +++ b/guide/english/rest-api/index.md @@ -14,6 +14,15 @@ REST was developed to provide a uniform interface for - Self-descriptive messages - Using Hypermedia as the Engine of Application State (HATEOS) +REST is not an architecture, but a set of design criteria. +Resource-Oriented Architecture (ROA) is a RESTful +architecture that provides a common sense set of rules and a +step-by-step procedure for designing RESTful Web services +following these design criteria. Each resource has a name +(i.e. a URI) and a representation, and it may be linked to other +resources via hyperlinks. + + ### Best Practices - #### Basics