From 133ff5790fce5bf3ed0949b25b9208e07f16d163 Mon Sep 17 00:00:00 2001 From: Janice Niemeir Date: Wed, 24 Oct 2018 14:00:07 -0700 Subject: [PATCH 1/2] Content Edits Small content edits. --- docs/api/concepts.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/api/concepts.md b/docs/api/concepts.md index e0c6f926d..f937f4d33 100644 --- a/docs/api/concepts.md +++ b/docs/api/concepts.md @@ -26,21 +26,21 @@ An adapter exposes: ## Tasks -Each gulp task is an asynchronous JavaScript function that either accepts an error-first callback or returns a stream, promise, event emitter, child process, or observable. Due to some platform limitations, synchronous tasks aren't supported. +Each gulp task is an asynchronous JavaScript function that accepts an error-first callback or returns a stream, promise, event emitter, child process, or observable. Due to some platform limitations, synchronous tasks aren't supported. For a more detailed explanation, see [Creating Tasks][creating-tasks-doc]. ## Globs -A glob is a string of literal and/or wildcard characters, like `*`, `**`, `!`, used to match filepaths. Globbing is the act of locating files on a file system using one or more globs. +A glob is a string of literal and/or wildcard characters, like `*`, `**`, or `!`, used to match filepaths. Globbing is the act of locating files on a file system using one or more globs. If you don't have experience with globs, see [Explaining Globs][explaining-globs-docs]. ## Glob base -A glob base - sometimes called glob parent - is the path segment before any special characters in a glob string. As such, the glob base of `/src/js/**.js` is `/src/js/`. All paths that match the glob are guaranteed to share the glob base since that path segment can't be variable. +A glob base - sometimes called glob parent - is the path segment before any special characters in a glob string. As such, the glob base of `/src/js/**.js` is `/src/js/`. All paths that match the glob are guaranteed to share the glob base - that path segment can't be variable. -Vinyl instances generated by `src()` are constructed with the glob base set as their `base` property. When written to the file system with `dest()`, the `base` will be removed from the output path so directory structures will be preserved. +Vinyl instances generated by `src()` are constructed with the glob base set as their `base` property. When written to the file system with `dest()`, the `base` will be removed from the output path to preserve directory structures. For more in depth information, see the [glob-parent][glob-parent-external] repository. @@ -56,7 +56,7 @@ File system modes determine what permissions exist for a file. Most files and di Gulp is made up of many small modules that are pulled together to work cohesively. By utilizing [semver][semver-external] within the small modules, we can release bug fixes and features without publishing new versions of gulp. Often, when you don't see progress on the main repository, work is being done in one of these modules. -If you're having trouble, ensure your current modules are updated - using the `npm update` command. If the problem persists, open an issue on the individual project repository. +If you're having trouble, ensure your current modules are updated using the `npm update` command. If the problem persists, open an issue on the individual project repository. * [undertaker][undertaker-external] - the task registration system * [vinyl][vinyl-external] - the virtual file objects From 788471d9e0c5d7adf255afd1524a2fd2f314df84 Mon Sep 17 00:00:00 2001 From: Blaine Bublitz Date: Wed, 24 Oct 2018 15:12:35 -0700 Subject: [PATCH 2/2] Update docs/api/concepts.md Co-Authored-By: Janiceilene --- docs/api/concepts.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/concepts.md b/docs/api/concepts.md index f937f4d33..3f1529057 100644 --- a/docs/api/concepts.md +++ b/docs/api/concepts.md @@ -26,7 +26,7 @@ An adapter exposes: ## Tasks -Each gulp task is an asynchronous JavaScript function that accepts an error-first callback or returns a stream, promise, event emitter, child process, or observable. Due to some platform limitations, synchronous tasks aren't supported. +Each gulp task is an asynchronous JavaScript function that either accepts an error-first callback or returns a stream, promise, event emitter, child process, or observable. Due to some platform limitations, synchronous tasks aren't supported. For a more detailed explanation, see [Creating Tasks][creating-tasks-doc].