         ...
       end
 
+  ## Examples
+
+      scope "/api/v1", API.V1, as: :api_v1 do
+        get "/pages/:id", PageController, :show
+      end
+
   """
   defmacro scope(path, alias, options, do: context) do
     options = quote do


  ## Examples

      scope "/api/v1", as: :api_v1, alias: API.V1 do
        get "/pages/:id", PageController, :show
      end


        ...
      end

  ## Examples

      scope "/api/v1", as: :api_v1, alias: API.V1 do
        get "/pages/:id", PageController, :show
      end

  """
  defmacro scope(path, options, do: context) do
    options = quote do
