diff --git a/src/en/clean-copy/02-Section I. The API Design/01.md b/src/en/clean-copy/02-Section I. The API Design/01.md index 5f4b980..96df4bb 100644 --- a/src/en/clean-copy/02-Section I. The API Design/01.md +++ b/src/en/clean-copy/02-Section I. The API Design/01.md @@ -1,13 +1,13 @@ ### The API Contexts Pyramid The approach we use to design APIs comprises four steps: - * defining an application field; - * separating abstraction levels; - * isolating responsibility areas; + * defining an application field + * separating abstraction levels + * isolating responsibility areas * describing final interfaces. -This four-step algorithm actually builds an API from top to bottom, from common requirements and use case scenarios down to a refined entity nomenclature. In fact, moving this way will eventually conclude with a ready-to-use API — that's why we value this approach highly. +This four-step algorithm actually builds an API from top to bottom, from common requirements and use case scenarios down to a refined nomenclature of entities. In fact, moving this way will eventually conclude with a ready-to-use API, and that's why we value this approach highly. It might seem that the most useful pieces of advice are given in the last chapter, but that's not true. The cost of a mistake made at certain levels differs. Fixing the naming is simple; revising the wrong understanding of what the API stands for is practically impossible. -**NB**. Here and throughout we will illustrate API design concepts using a hypothetical example of an API allowing for ordering a cup of coffee in city cafes. Just in case: this example is totally synthetic. If we were to design such an API in the real world, it would probably have very little in common with our fictional example. \ No newline at end of file +**NB**. Here and throughout we will illustrate the API design concepts using a hypothetical example of an API allowing for ordering a cup of coffee in city cafes. Just in case: this example is totally synthetic. If we were to design such an API in the real world, it would probably have very little in common with our fictional example. \ No newline at end of file