Amend news and lintr config search description

Fixed the description based on review, performed very minor copy
editing, and adapted formatting to be consistent.

Author: klmr

NEWS.md

@@ -2,7 +2,7 @@
 
 ## Deprecations & Breaking Changes
 
-* .lintr configs can now be kept in the directory .github/linters for better compatibility with Super-Linter. Note that this may be a breaking change if you already have a config in both such a directory and in your R project's root since the former will now be discovered first where it was ignored before. Please see vignette("lintr") for details on how configs are discovered. (#1746, @tonyk7440)
+* `.lintr` files can now be kept in the directory `.github/linters` for better compatibility with Super-Linter. Note that this may be a breaking change if you already have a config in `.github/linters` inside a subdirectory as well as in your R project's root, since the former will now be discovered first where it was ignored before. Please see `vignette("lintr")` for details on how configs are discovered (#1746, @tonyk7440 and @klmr).
 * `single_quotes_linter()` is deprecated in favor of the more generalizable `quotes_linter()` (#1729, @MichaelChirico).
 * `unneeded_concatentation_linter()` is deprecated in favor of `unnecessary_concatenation_linter()` for naming consistency (#1707, @IndrajeetPatil).
 * `consecutive_stopifnot_linter()` is deprecated in favor of the more general (see below) `consecutive_assertion_linter()` (#1604, @MichaelChirico).

vignettes/lintr.Rmd

@@ -91,9 +91,9 @@ exclusions: list(
 More generally, `lintr` searches for a settings file according to following prioritized list.
 The first one found, if any, will be used.
 
-1.  If `options(lintr.linter_file)` is an absolute path, this file will be used. The default for this option is `".lintr"`.
-2.  A linter file (that is a file named like `lintr.linter_file`) in the currently searched directory, i.e. the directory of the file passed to `lint()`. When run from `lint_package()`, this directory can differ for each linted file.
-3.  A linter file in the `.github/linters` child directory of the currently-searched directory.
+1.  If `options("lintr.linter_file")` is an absolute path, this file will be used. The default for this option is `".lintr"`.
+2.  A linter file (that is a file named like `lintr.linter_file`) in the currently-searched directory, i.e. the directory of the file passed to `lint()`, or in the closest parent directory. When run from `lint_package()`, this directory can differ for each linted file.
+3.  A linter file in the `.github/linters` child directory of the currently-searched directory, or in the closest parent directory.
 4.  A linter file in a parent directory of the currently-searched directory, starting from the deepest path, moving upwards one level at a time.
 5.  A linter file in the user's `HOME` directory.