Work on NEWS

Author: jennybc

NEWS.md

@@ -24,27 +24,22 @@ usethis has a more sophisticated understanding of the default branch and gains s
 * `git_sitrep()` exposes `init.defaultBranch` and surfaces the more
   sophisticated analysis of `git_default_branch()`.
 
-## Other
+## Other GitHub-related changes
 
-* `use_github_file()` is a new function related to `use_template()`, which grabs
-  the contents of an arbitrary file on GitHub, with support for targeting a
-  specific branch, tag, or commit and for following symlinks (#1407). It is now
-  used by `use_github_action()` and friends.
+* `use_github_file()` is a new function related to `use_template()`. Instead of
+  starting from a local file, `use_github_file()` grabs the contents of an
+  arbitrary file on GitHub that the user has permission to read. It supports
+  targeting a specific branch, tag, or commit and can follow a symlink (#1407).
+  `use_github_file()` now powers `use_github_action()` and friends.
 
 * `use_release_issue()` also takes bullets from `release_questions()`, 
   for compatibility with `devtools::release()`.
 
-* `use_pkgdown()` automatically uses bootstrap4 if the pkgdown version supports
-  it (anticipated for pkgdown 2.0.0).
-
 * `git_vaccinate()`, `edit_git_ignore()`, and `git_sitrep()` are more careful to
-  consult, reveal, and set the `core.excludesFile` in user's Git configuration
-  (#1461).
-
-* `use_github_action_*()` functions have been updated in response to the
-  pak-based workflows becoming the standard workflows in `r-lib/actions`.
+  consult, reveal, and set the `core.excludesFile` setting in user's Git
+  configuration (#1461).
 
-* `use_github_action_check_full()` has been removed since it's overkill for the
+* `use_github_action_check_full()` has been removed. It's overkill for the
   majority of R packages, which are better off with `use_github_actions()` or
   `use_github_action_check_standard()` (#1490).
 
@@ -53,48 +48,75 @@ usethis has a more sophisticated understanding of the default branch and gains s
   GitHub behaviour, where it has become essentially impossible to refer to the
   empty tree (#1472).
 
-* `"usethis.overwrite"` is a new option. When set to `TRUE`, usethis overwrites
-  an existing file without asking for user confirmation if the file is inside
-  a Git repo. The normal Git workflow makes it easy to see and selectively
-  accept/discard any proposed changes. This behaviour is strictly opt-in
-  (#1424).
+* `use_tidy_labels()` has been renamed to `use_tidy_github_labels()` (#1430).
+
+* The minimum version of gh has been bumped to help / force more people to
+  upgrade to the gh version that supports current GitHub PAT formats
+  (@ijlyttle, #1454).
+  
+* `use_github()` can create repositories with `"internal"` visiblity, a feature
+  that exists within GitHub Enterprise products (#1505).
 
+* `git_sitrep()` and `gh_token_help()` try even harder to help people get on the
+  happy path with respect to their GitHub PAT (#1400, #1413, #1488, #1489,
+  #1497).
+
+* `use_tidy_github_labels()` is the new name for `use_tidy_labels()` (#1430).
+
+* `use_tidy_github_actions()` takes over for `use_tidy_ci()`, which is now
+  deprecated.
+
+## Package development
+
+* `use_pkgdown()` automatically uses bootstrap4 if the pkgdown version supports
+  it (anticipated for pkgdown 2.0.0).
+
 * `use_lifecycle()` now imports `lifecycle::deprecated()` (#1419).
 
 * `use_code_of_conduct()` now requires a `contact` argument to supply contact
   details for reporting CoC violations (#1269).
 
-* We no longer suggest including your test environments in `cran-comments.md`,
-  since there's no evidence that CRAN finds it useful, and it's annoying to
-  keep up to date (#1365). 
-  
 * `use_tidy_release_test_env()` has been deleted since we no longer recommend
-  including test environment in CRAN comments (#1365).
+  including test environments in `cran-comments.md`. There's no evidence that
+  CRAN finds it useful, and it's annoying to keep up-to-date  (#1365).
 
 * Added `use_import_from()` to put `@importFrom pkg fun` into a package in a 
-  consistent way (@malcolmbarrett, #1377)
+  consistent way (@malcolmbarrett, #1377).
 
 * `DESCRIPTION` files generated by usethis no longer include `LazyData` by 
-   default per new CRAN checks; instead, `LazyData` is now added the first time 
-   you use `use_data()` (@malcolmbarrett, #1404)
-   
-* Functions that provide code to load packages in your `.Rprofile` now use
-  `rlang::check_installed()` to make sure the package is installed locally
-  (@malcolmbarrett, #1398)
- 
+   default, as per new CRAN checks; instead, `LazyData` is now added the first
+   time you use `use_data()` (@malcolmbarrett, #1404).
+
 * `use_package()` no longer guides the user on how to use a dependency when no 
-  change was made (@malcolmbarrett, #1384)
-  
-* The minimum version of gh has been bumped to help more people upgrade to the gh version that supports current GitHub PAT formats (#1454 @ijlyttle).
+  change was made (@malcolmbarrett, #1384).
 
-* `edit_rstudio_prefs()` and `edit_rstudio_snippets()` should work now on case-sensitive OSes, due to a path fix re: the location of RStudio's config files (#1420 @charliejhadley).
+* `use_tidy_eval()` has been updated to reflect current recommendations for
+  using (and therefore exposing) tidy eval in other packages (@lionel-, #1445).
 
-* `use_tidy_eval()` has been updated to reflect current recommendations for using (and therefore exposing) tidy eval in other packages (@lionel-, #1445).
+* `use_readme_[r]?md()` no longer includes CRAN installation instructions in the
+  initial template; instead, we only include GitHub-based install instructions
+  or otherwise prompt the user to update instructions (#1507).
+  
+* `use_tidy_dependencies()` is a new function that sets up standard dependencies
+  used by all tidyverse packages, except those that are designed to be
+  dependency free (#1423).
 
-* `use_tidy_labels()` has been renamed to `use_tidy_github_labels()` (#1430).
 
-* `use_readme_[r]?md()` no longer includes CRAN install instructions in the
-initial template; instead, we only include GitHub-based install instructions or otherwise prompt the user to update instructions (#1507).
+## User-level configuration
+
+* `"usethis.overwrite"` is a new option. When set to `TRUE`, usethis overwrites
+  an existing file without asking for user confirmation if the file is inside
+  a Git repo. The normal Git workflow makes it easy to see and selectively
+  accept/discard any proposed changes. This behaviour is strictly opt-in
+  (#1424).
+  
+* Functions that provide code to load packages in your `.Rprofile` now use
+  `rlang::check_installed()` to make sure the package is installed locally
+  (@malcolmbarrett, #1398).
+ 
+* `edit_rstudio_prefs()` and `edit_rstudio_snippets()` should work now on
+  case-sensitive OSes, due to a path fix re: the location of RStudio's config
+  files (@charliejhadley, #1420).
 
 # usethis 2.0.1