Adding some doc comments

Hey,

I was adding some doc comments. Going through the code, I have fixed a few PSR inconsistency.

Some of the things I noticed are

1 ) PackageXmlParser and 2 ) PackageJsonParser have a different api. 

In one you are expecting a directory path, in the other you expect the .json path. I feel it is worth to change.

Also the gitIgnoreFiles method seems spread, seems some sort of refactoring is good.

Thanks
Yes, should be named released. To create an archive from it will be
optional.
On Jun 14, 2014 10:44 AM, "Christophe Coevoet" <notifications@github.com>
wrote:

> In src/Console/Command/ValidateCommand.php:
>
> > @@ -22,6 +27,15 @@ protected function configure()
> >              );
> >      }
> >
> > +    /**
> > +     *
> > +     * Execute archive
>
> the description in the parent class is enough IMO, and this one is wrong
> anyway, as this command does not archive anything
>
> —
> Reply to this email directly or view it on GitHub
> <https://github.com/pierrejoye/pickle/pull/2/files#r13780006>.
>