diff --git a/agora pkg chapter.md b/agora pkg chapter.md
index ba9db971e..3baafc2ba 100644
--- a/agora pkg chapter.md	
+++ b/agora pkg chapter.md	
@@ -411,9 +411,9 @@ Agoras can define mappings from these to URL schemes generalizing to isomorphic
 
 #### Entity resolution
 - GET /@<user> -> provides details about a user and the [[subnodes]] in their repositories.
-- GET /users -> lists
+- GET /users -> lists users
 - GET /node/<node> -> entity resolution
-- GET /nodes -> lists
+- GET /nodes -> lists known entities in canonical form
 - … 
 
 #### Feeds