diff --git a/Resources/doc/index.md b/Resources/doc/index.md
index f632a2706..39ee9ce9b 100644
--- a/Resources/doc/index.md
+++ b/Resources/doc/index.md
@@ -464,8 +464,10 @@ nelmio_api_doc:
             method:               ~ # One of "format_param"; "accept_header"
             default_format:       json
         authentication:
-            name:                 ~ # Required
             delivery:             ~ # Required
-            type:                 ~
+            name:                 ~ # Required
+
+            # Required if http delivery is selected.
+            type:                 ~ # One of "basic"; "bearer"
             custom_endpoint:      false
 ```