diff --git a/lib/suggest.js b/lib/suggest.js
index c262c02e4b..c86d5d2934 100644
--- a/lib/suggest.js
+++ b/lib/suggest.js
@@ -1,3 +1,7 @@
+// Suggestion API
+//
+// eg. /$suggest/v1?url=https://github.com/badges/shields
+
 'use strict'
 
 const nodeUrl = require('url')