document how root routes coexist with dynamic api routes

document how root routes coexist with dynamic api routes - related to vercel#11542

docs/api-routes/dynamic-api-routes.md

@@ -20,6 +20,24 @@ export default (req, res) => {
 
 Now, a request to `/api/post/abc` will respond with the text: `Post: abc`.
 
+### Index routes and Dynamic API routes
+
+A very common RESTful pattern is to set up routes like this:
+
+- `GET api/posts/` - gets a list of posts, probably paginated
+- `GET api/posts/12345` - gets post id 12345
+
+We can model this in two ways:
+
+- Option 1:
+  - `/api/posts.js`
+  - `/api/posts/[postId].js`
+- Option 2:
+  - `/api/posts/index.js`
+  - `/api/posts/[postId].js`
+
+Both are equivalent.
+
 ### Catch all API routes
 
 API Routes can be extended to catch all paths by adding three dots (`...`) inside the brackets. For example: