diff --git a/lib/liquid/standardfilters.rb b/lib/liquid/standardfilters.rb
index fade736c..453fbc12 100644
--- a/lib/liquid/standardfilters.rb
+++ b/lib/liquid/standardfilters.rb
@@ -22,7 +22,14 @@ module Liquid
     )
     STRIP_HTML_TAGS = /<.*?>/m
 
-    # Return the size of an array or of an string
+    # @public_docs
+    # @title Size
+    # @syntax The syntax
+    # @summary The summary
+    # @type filter
+    # @category My category
+    # @description
+    #   Return the size of an array or of an string
     def size(input)
       input.respond_to?(:size) ? input.size : 0
     end
diff --git a/lib/liquid/tags/assign.rb b/lib/liquid/tags/assign.rb
index 6d4f7d8d..85c56adc 100644
--- a/lib/liquid/tags/assign.rb
+++ b/lib/liquid/tags/assign.rb
@@ -1,14 +1,20 @@
 # frozen_string_literal: true
 
+# @public_docs
 module Liquid
-  # Assign sets a variable in your template.
+  # @public_docs
+  # @title Assign
+  # @syntax The syntax
+  # @summary The summary
+  # @type tag
+  # @description
+  #   Assign sets a variable in your template.
   #
-  #   {% assign foo = 'monkey' %}
+  #     {% assign foo = 'monkey' %}
   #
-  # You can then use the variable later in the page.
-  #
-  #  {{ foo }}
+  #   You can then use the variable later in the page.
   #
+  #     {{ foo }}
   class Assign < Tag
     Syntax = /(#{VariableSignature}+)\s*=\s*(.*)\s*/om