From 65345912a9919335e6183487150066f3397c3b2a Mon Sep 17 00:00:00 2001
From: mRoca <mroca.dh@gmail.com>
Date: Tue, 9 Jun 2015 15:33:22 +0200
Subject: [PATCH] Add DunglasApiBundle doc sections

---
 .../DunglasApiProvider.php                    |   1 +
 Tests/Formatter/MarkdownFormatterTest.php     | 165 +++++++++---------
 Tests/Formatter/SimpleFormatterTest.php       |   5 +
 3 files changed, 90 insertions(+), 81 deletions(-)

diff --git a/Extractor/AnnotationsProvider/DunglasApiProvider.php b/Extractor/AnnotationsProvider/DunglasApiProvider.php
index b317c5d..c80bd4e 100644
--- a/Extractor/AnnotationsProvider/DunglasApiProvider.php
+++ b/Extractor/AnnotationsProvider/DunglasApiProvider.php
@@ -114,6 +114,7 @@ class DunglasApiProvider implements AnnotationsProviderInterface
             'resource' => $route->getPath(),
             'description' => $operationHydraDoc['hydra:title'],
             'resourceDescription' => $resourceHydraDoc['hydra:title'],
+            'section' => $resourceHydraDoc['hydra:title'],
         ];
 
         $entityClass = $resource->getEntityClass();
diff --git a/Tests/Formatter/MarkdownFormatterTest.php b/Tests/Formatter/MarkdownFormatterTest.php
index f441c65..28f456e 100644
--- a/Tests/Formatter/MarkdownFormatterTest.php
+++ b/Tests/Formatter/MarkdownFormatterTest.php
@@ -27,6 +27,90 @@ class MarkdownFormatterTest extends WebTestCase
 
         if (class_exists('Dunglas\ApiBundle\DunglasApiBundle')) {
 $expected = <<<MARKDOWN
+# Popo #
+
+### `GET` /popos ###
+
+_Retrieves the collection of Popo resources._
+
+#### Response ####
+
+foo:
+
+  * type: string
+
+
+### `POST` /popos ###
+
+_Creates a Popo resource._
+
+#### Parameters ####
+
+foo:
+
+  * type: string
+  * required: false
+
+#### Response ####
+
+foo:
+
+  * type: string
+
+
+### `GET` /popos/{id} ###
+
+_Retrieves Popo resource._
+
+#### Requirements ####
+
+**id**
+
+  - Type: int
+
+#### Response ####
+
+foo:
+
+  * type: string
+
+
+### `PUT` /popos/{id} ###
+
+_Replaces the Popo resource._
+
+#### Requirements ####
+
+**id**
+
+  - Type: string
+
+#### Parameters ####
+
+foo:
+
+  * type: string
+  * required: false
+
+#### Response ####
+
+foo:
+
+  * type: string
+
+
+### `DELETE` /popos/{id} ###
+
+_Deletes the Popo resource._
+
+#### Requirements ####
+
+**id**
+
+  - Type: string
+
+
+
 ## /api/other-resources ##
 
 ### `GET` /api/other-resources.{_format} ###
@@ -670,87 +754,6 @@ _This method is useful to test if the getDocComment works._
   - Description: The param id
 
 
-### `GET` /popos ###
-
-_Retrieves the collection of Popo resources._
-
-#### Response ####
-
-foo:
-
-  * type: string
-
-
-### `POST` /popos ###
-
-_Creates a Popo resource._
-
-#### Parameters ####
-
-foo:
-
-  * type: string
-  * required: false
-
-#### Response ####
-
-foo:
-
-  * type: string
-
-
-### `GET` /popos/{id} ###
-
-_Retrieves Popo resource._
-
-#### Requirements ####
-
-**id**
-
-  - Type: int
-
-#### Response ####
-
-foo:
-
-  * type: string
-
-
-### `PUT` /popos/{id} ###
-
-_Replaces the Popo resource._
-
-#### Requirements ####
-
-**id**
-
-  - Type: string
-
-#### Parameters ####
-
-foo:
-
-  * type: string
-  * required: false
-
-#### Response ####
-
-foo:
-
-  * type: string
-
-
-### `DELETE` /popos/{id} ###
-
-_Deletes the Popo resource._
-
-#### Requirements ####
-
-**id**
-
-  - Type: string
-
-
 ### `ANY` /return-nested-output ###
 
 
diff --git a/Tests/Formatter/SimpleFormatterTest.php b/Tests/Formatter/SimpleFormatterTest.php
index bfb4e3c..3082547 100644
--- a/Tests/Formatter/SimpleFormatterTest.php
+++ b/Tests/Formatter/SimpleFormatterTest.php
@@ -1634,6 +1634,7 @@ And, it supports multilines until the first \'@\' char.',
                                     ),
                                 'deprecated' => false,
                                 'resourceDescription' => 'Popo',
+                                'section' => 'Popo',
                             ),
                         8 =>
                             array (
@@ -1668,6 +1669,7 @@ And, it supports multilines until the first \'@\' char.',
                                     ),
                                 'deprecated' => false,
                                 'resourceDescription' => 'Popo',
+                                'section' => 'Popo',
                             ),
                         9 =>
                             array (
@@ -1701,6 +1703,7 @@ And, it supports multilines until the first \'@\' char.',
                                     ),
                                 'deprecated' => false,
                                 'resourceDescription' => 'Popo',
+                                'section' => 'Popo',
                             ),
                         10 =>
                             array (
@@ -1744,6 +1747,7 @@ And, it supports multilines until the first \'@\' char.',
                                     ),
                                 'deprecated' => false,
                                 'resourceDescription' => 'Popo',
+                                'section' => 'Popo',
                             ),
                         11 =>
                             array (
@@ -1767,6 +1771,7 @@ And, it supports multilines until the first \'@\' char.',
                                     ),
                                 'deprecated' => false,
                                 'resourceDescription' => 'Popo',
+                                'section' => 'Popo',
                             ),
                         12 =>
                             array (