docs: Fix description and default value for sourceMapReferences (#318)

* docs: Fix description and default value for sourceMapReferences

* Apply suggestions from code review

Co-authored-by: Katie Byers <katie.byers@sentry.io>

Co-authored-by: Katie Byers <katie.byers@sentry.io>

Author: kamilogorek

README.md

@@ -78,7 +78,7 @@ Also, check the [example](example) directory.
 | validate           | `boolean`                                                                           | optional | When `true`, attempts source map validation before upload if rewriting is not enabled. It will spot a variety of issues with source maps and cancel the upload if any are found. Defaults to `false` to prevent false positives canceling upload.                                                                                                                               |
 | stripPrefix        | `array`                                                                             | optional | When paired with `rewrite`, will remove a prefix from filename references inside of sourcemaps. Useful for removing a path that is build-machine-specific. Note that this will NOT change the names of uploaded files.                                                                                                                                                          |
 | stripCommonPrefix  | `boolean`                                                                           | optional | When paired with `rewrite`, will add `~` to the `stripPrefix` array. Defaults to `false`.                                                                                                                                                                                                                                                                                       |
-| sourceMapReference | `boolean`                                                                           | optional | Prevents the automatic detection of sourcemap references. Defaults to `false`.                                                                                                                                                                                                                                                                                                  |
+| sourceMapReference | `boolean`                                                                           | optional | Determines whether sentry-cli should attempt to link minified files with their corresponding maps. By default, it will match files and maps based on name, and add a `Sourcemap` header to each minified file for which it finds a map. Can be disabled if all minified files contain `sourceMappingURL`. Defaults to `true`.                                                                                           |
 | rewrite            | `boolean`                                                                           | optional | Enables rewriting of matching source maps so that indexed maps are flattened and missing sources are inlined if possible. Defaults to `true`                                                                                                                                                                                                                                    |
 | finalize           | `boolean`                                                                           | optional | Determines whether Sentry release record should be automatically finalized (`date_released` timestamp added) after artifact upload. Defaults to `true`                                                                                                                                                                                                                          |
 | dryRun             | `boolean`                                                                           | optional | Attempts a dry run (useful for dev environments). Defaults to `false`.                                                                                                                                                                                                                                                                                                          |