Implement deprecated tag

Author: timvdalen

src/Docs/RouteDocumentation.php

@@ -17,6 +17,7 @@ class RouteDocumentation {
 	protected $description;
 	protected $params;
 	protected $return;
+	protected $deprecated;
 
 	public $resource;
 
@@ -64,6 +65,13 @@ public function __construct(Route $route) {
 		} else {
 			$this->return = new ReturnValue(ReturnValue::$OTHER, '');
 		}
+
+		$deprecation = $docBlock->getTagsByName('deprecated');
+		if (count($deprecation) > 0) {
+			$tag = $deprecation[0];
+			$notice = $tag->getContent();
+			$this->deprecated = empty($notice) ? true : $notice;
+		}
 	}
 
 	/**
@@ -150,5 +158,13 @@ public function getReturn() {
 	public function getResource() {
 		return $this->resource;
 	}
+
+	public function isDeprecated() {
+		return isset($this->deprecated);
+	}
+
+	public function getDeprecationMessage() {
+		return ($this->deprecated === true) ? false : $this->deprecated;
+	}
 }
 

src/views/endpoint.blade.php

@@ -4,6 +4,14 @@
 
 {!! $endpoint->getDescription() !!}
 
+@if ($endpoint->isDeprecated())
+@if ($message = $endpoint->getDeprecationMessage())
+<aside class="warning"><strong>Deprecated:</strong> {{$message}}</aside>
+@else
+<aside class="warning"><strong>Deprecated</strong></aside>
+@endif
+@endif
+
 @if (count($endpoint->getParams()) > 0)
 ### Parameters