Add docs

docs/how-to/adding-your-own-tag.rst

@@ -0,0 +1,9 @@
+How to Add Your Own Tag
+=======================
+
+This guide demonstrates how to add your own custom tag to a DocBlock using ReflectionDocBlock.
+
+.. literalinclude:: ../examples/04-adding-your-own-tag.php
+   :language: php
+   :linenos:
+

docs/how-to/index.rst

@@ -0,0 +1,13 @@
+How-to Guides
+=============
+
+Practical guides for common tasks with ReflectionDocBlock:
+
+.. toctree::
+   :maxdepth: 1
+
+   interpreting-a-simple-docblock
+   interpreting-tags
+   reconstituting-a-docblock
+   adding-your-own-tag
+

docs/how-to/interpreting-a-simple-docblock.rst

@@ -0,0 +1,9 @@
+How to Interpret a Simple DocBlock
+==================================
+
+This guide demonstrates how to parse a simple DocBlock and extract its summary and description using ReflectionDocBlock.
+
+.. literalinclude:: ../examples/01-interpreting-a-simple-docblock.php
+   :language: php
+   :linenos:
+

docs/how-to/interpreting-tags.rst

@@ -0,0 +1,9 @@
+How to Interpret Tags in a DocBlock
+===================================
+
+This guide demonstrates how to interpret tags within a DocBlock using ReflectionDocBlock.
+
+.. literalinclude:: ../examples/02-interpreting-tags.php
+   :language: php
+   :linenos:
+

docs/how-to/reconstituting-a-docblock.rst

@@ -0,0 +1,9 @@
+How to Reconstitute a DocBlock
+==============================
+
+ReflectionDocBlock not only allows you to read and interpret DocBlocks, but also to reconstruct them. This is useful if you need to add, remove, or modify tags in your codebase programmatically.
+
+.. literalinclude:: ../examples/03-reconstituting-a-docblock.php
+   :language: php
+   :linenos:
+