diff --git a/README.md b/README.md
index 470203f..1c6465e 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,9 @@ class PetsController < ActionController::Base
     operation :get do
       key :description, 'Returns a single pet if the user has access'
       key :operationId, 'findPetById'
+      key :tags, [
+        'pet'
+      ]
       parameter do
         key :name, :id
         key :in, :path
@@ -75,6 +78,9 @@ class PetsController < ActionController::Base
         'application/json',
         'text/html',
       ]
+      key :tags, [
+        'pet'
+      ]
       parameter do
         key :name, :tags
         key :in, :query
@@ -116,6 +122,9 @@ class PetsController < ActionController::Base
       key :produces, [
         'application/json'
       ]
+      key :tags, [
+        'pet'
+      ]
       parameter do
         key :name, :pet
         key :in, :body
@@ -231,6 +240,14 @@ class ApidocsController < ActionController::Base
         key :name, 'MIT'
       end
     end
+    tags do
+      key :name, 'pet'
+      key :description, 'Pets operations'
+      externalDocs do
+        key :description, 'Find more info here'
+        key :url, 'https://swagger.io'
+      end
+    end
     key :host, 'petstore.swagger.wordnik.com'
     key :basePath, '/api'
     key :consumes, ['application/json']