findfiles2 doc clarity improvements (microsoft#205902)

Author: andreamah

src/vscode-dts/vscode.proposed.findFiles2.d.ts

@@ -54,13 +54,14 @@ declare module 'vscode' {
 
 		/**
 		 * Whether symlinks should be followed while searching.
-		 * See the vscode setting `"search.followSymlinks"`.
+		 * Defaults to the value for `search.followSymlinks` in settings.
+		 * For more info, see the setting listed above.
 		 */
 		followSymlinks?: boolean;
 
 		/**
 		 * If set to true, the `filePattern` arg will be fuzzy-searched instead of glob-searched.
-		 * If `filePattern` is a `GlobPattern`, then the fuzzy search will act on the `pattern` of the `RelativePattern`
+		 * If `filePattern` is a {@link RelativePattern relative pattern}, then the fuzzy search will act on the `pattern` of the {@link RelativePattern RelativePattern}
 		 */
 		fuzzy?: boolean;
 	}
@@ -73,7 +74,7 @@ declare module 'vscode' {
 		 * Find files across all {@link workspace.workspaceFolders workspace folders} in the workspace.
 		 *
 		 * @example
-		 * findFiles('**​/*.js', {exclude: '**​/out/**', useIgnoreFiles: true}, 10)
+		 * findFiles('**​/*.js', {exclude: '**​/out/**', useIgnoreFiles: true, maxResults: 10})
 		 *
 		 * @param filePattern A {@link GlobPattern glob pattern} that defines the files to search for. The glob pattern
 		 * will be matched against the file paths of resulting matches relative to their workspace. Use a {@link RelativePattern relative pattern}