doc: add explanatory to path.resolve description

YakovL · Trott · commit 4e3dee48c8e9 · 2020-01-22T19:21:57.000-08:00
Fixes: nodejs#25542 PR-URL: nodejs#31430 Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Colin Ihrig <cjihrig@gmail.com> Reviewed-By: David Carlier <devnexen@gmail.com> Reviewed-By: Rich Trott <rtrott@gmail.com>
diff --git a/doc/api/path.md b/doc/api/path.md
@@ -477,7 +477,8 @@ an absolute path.
 The given sequence of paths is processed from right to left, with each
 subsequent `path` prepended until an absolute path is constructed.
 For instance, given the sequence of path segments: `/foo`, `/bar`, `baz`,
-calling `path.resolve('/foo', '/bar', 'baz')` would return `/bar/baz`.
+calling `path.resolve('/foo', '/bar', 'baz')` would return `/bar/baz`
+because `'baz'` is not an absolute path but `'/bar' + '/' + 'baz'` is.
 
 If after processing all given `path` segments an absolute path has not yet
 been generated, the current working directory is used.
