[nelmio/api-doc-bundle] needs to support 3.0

[jhkchan]

3.0 is released at https://github.com/nelmio/NelmioApiDocBundle 2 days ago, and if we run:

$ php composer.phar req nelmio/api-doc-bundle
Using version ^3.0 for nelmio/api-doc-bundle
./composer.json has been updated
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 5 installs, 0 updates, 0 removals
  - Installing zircote/swagger-php (2.0.13): Downloading (100%)         
  - Installing symfony/inflector (v3.4.1): Downloading (100%)         
  - Installing symfony/property-info (v3.4.1): Downloading (100%)         
  - Installing exsyst/swagger (v0.3.1): Downloading (100%)         
  - Installing nelmio/api-doc-bundle (v3.0.0): Downloading (100%)         
Writing lock file
Generating autoload files
Symfony operations: 1 recipe (be0b2c4d4fe82c143c60dcbf76d3a361)
  - Configuring nelmio/api-doc-bundle (>=2.13): From github.com/symfony/recipes-contrib:master
ocramius/package-versions:  Generating version class...
ocramius/package-versions: ...done generating version class
Executing script cache:clear [KO]
 [KO]
Script cache:clear returned with error code 1
!!  
!!   // Clearing the cache for the dev environment with debug                       
!!   // true                                                                        
!!  
!!  
!!  In FileLoader.php line 168:
!!                                                                                 
!!    Unable to find file "@NelmioApiDocBundle/Resources/config/routing.yml" in @  
!!    NelmioApiDocBundle/Resources/config/routing.yml (which is being imported fr  
!!    om "/Users/jhkchan/workspace/symfony34/config/routes/nelmio_a  
!!    pi_doc.yaml"). Make sure the "NelmioApiDocBundle" bundle is correctly regis  
!!    tered and loaded in the application kernel class. If the bundle is register  
!!    ed, make sure the bundle path "@NelmioApiDocBundle/Resources/config/routing  
!!    .yml" is not empty.                                                          
!!                                                                                 
!!  
!!  In Kernel.php line 307:
!!                                                                             
!!    Unable to find file "@NelmioApiDocBundle/Resources/config/routing.yml".  
!!                                                                             
!!  
!!  cache:clear [--no-warmup] [--no-optional-warmers] [-h|--help] [-q|--quiet] [-v|vv|vvv|--verbose] [-V|--version] [--ansi] [--no-ansi] [-n|--no-interaction] [-e|--env ENV] [--no-debug] [--] <command>
!!  
!!  

It would check 3.0 there and 2.13 on recipe, the routing path would break.

[stof]

Well, as NelmioApiDocBundle 3.0 has BC breaks compared to 2.x, a new version of the recipe has to be created. PRs are welcome to this bundle. And otherwise, you should report it to the maintainers of the bundle so that they can be the ones creating a new version of the recipe.