composer/composer — pull request #452 by weaverryan (2012-03-14 03:15:42+00:00)
Title: Proofreading the first and second chapters of the very well-written docs

Well hey there guys!

This is just some starting work for the docs. @igorw has done a really nice job, and I guess I get to enjoy the somewhat unique perspective of largely being a noob to composer :).

This is mostly rephrashing etc, but it did bring up a few questions I had. I'm happy to work these into the docs, but I'm still unclear on some of the details:

* We need to clarify what "monolog/monolog" means earlier - certainly at least by the "Package Names" section. This looks magical (what *is* monolog, where does it come from?) and you see it a bunch of times before seeing details about packagist

* In "Package Versions" we use `<1.1-dev` as an example, but we haven't seen this `-dev` stuff yet and I think it's a bit more advanced. Maybe we should leave this out, or explain right here what non-number version things there are and how they "rank"

And some things some people might be wonder:

* How does composer download things? Is it a tar? Do I need git? These are some questions I might be asking myself

* What if a library is not on packagist? Is that supported? Can I get packagist to crawl it? Can I add its git URL somewhere in my `composer.json` so I can include it in my project?

If I could get a few quick thoughts on this, I can get them worked in.

Thanks for the hard work guys!