diff --git a/doc/api/README.md b/doc/api/README.md
index b474e0ea389..f369c3fd978 100644
--- a/doc/api/README.md
+++ b/doc/api/README.md
@@ -4,7 +4,7 @@
 
 - [Users](users.md)
 - [Session](session.md)
-- [Projects](projects.md)
+- [Projects](projects.md) including setting Webhooks
 - [Project Snippets](project_snippets.md)
 - [Services](services.md)
 - [Repositories](repositories.md)
diff --git a/doc/api/projects.md b/doc/api/projects.md
index 17c014019ea..10533c73a31 100644
--- a/doc/api/projects.md
+++ b/doc/api/projects.md
@@ -4,16 +4,16 @@
 ### Project visibility level
 
 Project in GitLab has be either private, internal or public.
-You can determine it by `visibility_level` field in project. 
+You can determine it by `visibility_level` field in project.
 
 Constants for project visibility levels are next:
 
-* Private. `visibility_level` is `0`. 
+* Private. `visibility_level` is `0`.
   Project access must be granted explicitly for each user.
 
 * Internal. `visibility_level` is `10`.
   The project can be cloned by any logged in user.
- 
+
 * Public. `visibility_level` is `20`.
   The project can be cloned without any authentication.
 
@@ -362,7 +362,7 @@ Parameters:
 - `public` (optional) - if `true` same as setting visibility_level = 20
 - `visibility_level` (optional)
 
-On success, method returns 200 with the updated project. If parameters are 
+On success, method returns 200 with the updated project. If parameters are
 invalid, 400 is returned.
 
 ### Fork project
@@ -479,6 +479,9 @@ rely on the returned JSON structure.
 
 ## Hooks
 
+Also called Project Hooks and Webhooks.
+These are different for [System Hooks](system_hooks.md) that are system wide.
+
 ### List project hooks
 
 Get a list of project hooks.