Add @restdock-ignoreField and @restdock-ignoreExtraField tags

README.md

@@ -147,6 +147,18 @@ Use @restdoc-extraField and @restdoc-extraLink for extra fields.
 
 Use @restdoc-sortField to sort field according to your code.
 
+### Skip fields
+
+Use @restdoc-ignoreField and @restdoc-ignoreExtraField to skip field.
+
+```php
+
+/**
+ * @restdoc-ignoreField $hidden
+ * @restdoc-ignoreExtraField $hidden_too
+ */
+```
+
 ## Integrate With Slate
 
 [Slate](https://github.com/tripit/slate) is probably one of the best tools to generate nice API. So you can 

models/ModelDoc.php

@@ -44,6 +44,17 @@ private function _addField(&$fields, $name, $type = '', $description = '', $scen
         $fields[$name]->setType($type);
     }
 
+    /**
+     * @param array $fields
+     * @param string $name
+     */
+    private function _removeField(&$fields, $name)
+    {
+        if (isset($fields[$name])) {
+            unset($fields[$name]);
+        }
+    }
+
     /**
      * @param string $name
      * @param string $type
@@ -65,6 +76,22 @@ public function addExtraField($name, $type = '', $description = '')
         $this->_addField($this->_extraFields, $name, $type, $description);
     }
 
+    /**
+     * @param string $name
+     */
+    public function removeField($name)
+    {
+        $this->_removeField($this->_fields, $name);
+    }
+
+    /**
+     * @param string $name
+     */
+    public function removeExtraField($name)
+    {
+        $this->_removeField($this->_extraFields, $name);
+    }
+
     /**
      * @param $name
      */
@@ -263,6 +290,14 @@ public function prepare()
             }
         }
 
+        foreach ($this->getTagsByName('ignoreField') as $key => $tag) {
+            $this->removeField(trim($tag->getVariableName(), '$'));
+        }
+
+        foreach ($this->getTagsByName('ignoreExtraField') as $key => $tag) {
+            $this->removeExtraField(trim($tag->getVariableName(), '$'));
+        }
+
         foreach ($this->_fields as $field) {
             $field->prepare();
         }

models/Parser.php

@@ -59,6 +59,8 @@ public static function registerTagHandlers()
                 'label' => '\phpDocumentor\Reflection\DocBlock\Tag',
                 'extraField' => '\phpDocumentor\Reflection\DocBlock\Tag\ParamTag',
                 'extraLink' => '\phpDocumentor\Reflection\DocBlock\Tag\ParamTag',
+                'ignoreField' => '\phpDocumentor\Reflection\DocBlock\Tag\ParamTag',
+                'ignoreExtraField' => '\phpDocumentor\Reflection\DocBlock\Tag\ParamTag'
             ];
             foreach ($mapping as $suffix => $class) {
                 $tagName = Doc::TAG_PREFIX . $suffix;

tests/models/NewSpecialOffer.php

@@ -14,6 +14,7 @@ class NewSpecialOffer extends SpecialOffer
      * @inheritdoc
      *
      * @restdoc-extraField string $alpha2 Code country. <a href="http://example.com">Detail link.</a>
+     * @restdoc-ignoreExtraField $ignore
      */
     public function extraFields()
     {
@@ -23,6 +24,9 @@ public function extraFields()
             },
             'full_name' => function () {
                 return 'full_name';
+            },
+            'ignore' => function () {
+                return 'ignore';
             }
         ];
     }

tests/models/SpecialOffer.php

@@ -20,6 +20,7 @@ class SpecialOffer extends Product
      * @restdoc-link comment $text
      * @restdoc-link $comment
      * @restdoc-sortField $text
+     * @restdoc-ignoreField $is_ignore
      */
     public function fields()
     {
@@ -28,14 +29,15 @@ public function fields()
             'title' => function () {
                 return 'title';
             },
-            'text' => 'Comment'
+            'text' => 'Comment',
+            'is_ignore'
         ];
     }
 
     public function scenarios()
     {
         return [
-            'api-create' => ['id', 'title', 'note'],
+            'api-create' => ['id', 'title', 'note', 'is_ignore'],
             'api-update' => ['comment'],
         ];
     }

tests/unit/models/ModelParserTest.php

@@ -46,11 +46,13 @@ public function testInherit()
         $this->assertEquals('Code country. <a href="http://example.com">Detail link.</a>', $doc->extraFields['alpha2']->description);
         $this->assertEquals('string|null', $doc->extraFields['full_name']->type);
         $this->assertEquals('Full name. <a href="http://example.com">Detail link.</a>', $doc->extraFields['full_name']->description);
+        $this->assertFalse(isset($doc->extraFields['ignore']));
 
         $this->assertEquals(5, count($doc->fields));
         $this->assertEquals('int', $doc->fields['id']->type);
         $this->assertEquals('string', $doc->fields['title']->type);
         $this->assertEquals('string', $doc->fields['comment']->type);
+        $this->assertFalse(isset($doc->fields['is_ignore']));
 
         $this->assertEquals('string', $doc->fields['note']->type);
         $this->assertEquals('string', $doc->fields['text']->type);