Getting Started documentation

docs/documentation-missing.md

@@ -0,0 +1,5 @@
+## Excuse our dust!
+
+We're in the process of rewriting **all** our documentation and some of the links we've added to completed docs haven't been written yet. You've likely clicked on one of those to end up here. We're sorry about that but please check back later on the topic you're interested in.
+
+-The Gulp Team

docs/getting-started/1-quick-start.md

@@ -0,0 +1,92 @@
+<!-- front-matter
+id: quick-start
+title: Quick Start
+hide_title: true
+sidebar_label: Quick Start
+-->
+
+# Quick Start
+
+If you've previously installed gulp globally, run `npm rm --global gulp` before following these instructions. For more information, read this [Sip][sip-article].
+
+### Check for node, npm, and npx
+```sh
+node --version
+```
+![Output: v8.11.1][img-node-version-command]
+```sh
+npm --version
+```
+![Output: 5.6.0][img-npm-version-command]
+```sh
+npx --version
+```
+![Output: 9.7.1][img-npx-version-command]
+
+If they are not installed, follow the instructions [here][node-install].
+
+### Install the gulp command line utility
+```sh
+npm install --global gulp-cli
+```
+
+
+### Create a project directory and navigate into it
+```sh
+npx mkdirp my-project
+```
+```sh
+cd my-project
+```
+
+### Create a package.json file in your project directory
+```sh
+npm init
+```
+
+This will guide you through giving your project a name, version, description, etc.
+
+### Install the gulp package in your devDependencies
+```sh
+npm install --save-dev gulp
+```
+
+### Verify your gulp versions
+
+```sh
+gulp --version
+```
+
+Ensure the output matches the screenshot below or you might need to restart the steps in this guide.
+
+![Output: CLI version 2.0.1 & Local version 4.0.0][img-gulp-version-command]
+
+### Create a gulpfile
+Using your text editor, create a file named gulpfile.js in your project root with these contents:
+```js
+function defaultTask(cb) {
+  // place code for your default task here
+  cb();
+}
+
+exports.default = defaultTask
+```
+
+### Test it
+Run the gulp command in your project directory:
+```sh
+gulp
+```
+To run multiple tasks, you can use `gulp <task> <othertask>`.
+
+### Result
+The default task will run and do nothing.
+![Output: Starting default & Finished default][img-gulp-command]
+
+[sip-article]: https://medium.com/gulpjs/gulp-sips-command-line-interface-e53411d4467
+[node-install]: https://nodejs.org/en/
+[img-node-version-command]: https://gulpjs.com/img/docs-node-version-command.png
+[img-npm-version-command]: https://gulpjs.com/img/docs-npm-version-command.png
+[img-npx-version-command]: https://gulpjs.com/img/docs-npx-version-command.png
+[img-gulp-version-command]: https://gulpjs.com/img/docs-gulp-version-command.png
+[img-gulp-command]: https://gulpjs.com/img/docs-gulp-command.png

docs/getting-started/2-javascript-and-gulpfiles.md

@@ -0,0 +1,36 @@
+<!-- front-matter
+id: javascript-and-gulpfiles
+title: JavaScript and Gulpfiles
+hide_title: true
+sidebar_label: JavaScript and Gulpfiles
+-->
+
+# JavaScript and Gulpfiles
+
+Gulp allows you to use existing JavaScript knowledge to write gulpfiles or to use your experience with gulpfiles to write plain JavaScript. Although a few utilities are provided to simplify working with the filesystem and command line, everything else you write is pure JavaScript.
+
+## Gulpfile explained
+
+A gulpfile is a file in your project directory titled `gulpfile.js` (or capitalized as `Gulpfile.js`, like Makefile), that automatically loads when you run the `gulp` command. Within this file, you'll often see gulp APIs, like `src()`, `dest()`, `series()`, or `parallel()` but any vanilla JavaScript or Node modules can be used. Any exported functions will be registered into gulp's task system.
+
+## Transpilation
+
+You can write a gulpfile using a language that requires transpilation, like TypeScript or Babel, by changing the extension on your `gulpfile.js` to indicate the language and install the matching transpiler module.
+
+* For TypeScript, rename to `gulpfile.ts` and install the [ts-node][ts-node-module] module.
+* For Babel, rename to `gulpfile.babel.js` and install the [@babel/register][babel-register-module] module.
+
+For a more advanced dive into this topic and the full list of supported extensions, see our [gulpfile transpilation][gulpfile-transpilation-advanced] documentation.
+
+##  Splitting a gulpfile
+
+Many users start by adding all logic to a gulpfile. If it ever grows too big, it can be refactored into separate files.
+
+Each task can be split into its own file, then imported into your gulpfile for composition. Not only does this keep things organized, but it allows you to test each task independently or vary composition based on conditions.
+
+Node's module resolution allows you to replace your `gulpfile.js` with a directory called `gulpfile` that contains an `index.js` file which is treated as a `gulpfile.js`.  This directory could then contain your individual modules for tasks.
+
+
+[gulpfile-transpilation-advanced]: ../documentation-missing.md
+[ts-node-module]: https://www.npmjs.com/package/ts-node
+[babel-register-module]: https://www.npmjs.com/package/@babel/register