zircote/swagger-php — pull request #173 by RopoMen (2014-11-02 19:08:50+00:00)
Title: Couple of fixes to Partials and Parameter Annotation.

Hi,
I had no idea where to install Sphinx and I did install it first through apt-get and I got 1.1.2 version or something. It produced completely different kind of output than Sphinx 1.2.3 through pip. Well, anyhow...

Last Friday I was fighting to get partials work, I used your documentation from [here](http://zircote.com/swagger-php/partials.html). Everything worked well after I looked into your [source code](https://github.com/zircote/swagger-php/blob/master/library/Swagger/Annotations/Partial.php) instead, and noticed that @SWG\Partial() uses double quotes instead of single quotes to wrap partial_id!! :@

Then I also noticed that @SWG\Parameter() has couple of boolean properties, but those are wrapped in to double quotes in doc's. Example @SWG\Parameter(required="true") [in here](http://zircote.com/swagger-php/annotations.html#parameter) should be @SWG\Parameter(required=true) or you will get "Expecting boolean got string" error from [DataType.php](https://github.com/zircote/swagger-php/blob/master/library/Swagger/Annotations/DataType.php)

I also added a readme file which gets you started with document generation.

I dont know where those jquery and underscore libs came from, but I think those came when I used pip install Sphinx==1.2.3...

Br,
Markku Roponen