pull in external docs

[yocontra]

right now all of the docs are scattered amongst sub-repos, and our main repo just links to them. this is really really shitty and makes it difficult to know where to file issues and difficult to find documentation.

repos that need to be pulled in:

• vinyl-fs (for .src, .dest, and .symlink)
  • vinyl (for what files coming out of .src and .dest look like)
  • glob-stream (for .src)
• chokidar (for .watch)
• undertaker

[es128]

Ok. Let me see if I can help with the chokidar stuff tonight.

[phated]

Looking for some more people to contribute on the remaining items in this list.

[troch]

I thought I had commented on this, must have forgotten to click "Comment"... Looking at API.md on 4.0 branch, undertaker is referenced and its methods (task, lastRun, series, parallel) seem to have up-to-date documentation, but they are scattered. Should those API functions be grouped together, API.md split into smaller files, have a main file describing Gulp's main dependencies making its API...?

[Romanx]

I'll take a look at those that aren't pulled in and make a PR

[phated]

Ref #1446

[phated]

The projects listed (and even more) have been incorporated into our API Docs rewrite so I'm going to close this.

Note: We brought them all in by hand so they'll have to be kept up-to-date manually. That being said, most are controlled by us or don't change very often.