remove note about package docs problems (#1933)

* Update documentation.R

* Document

---------

Co-authored-by: jennybc <jennybc@users.noreply.github.com>

R/documentation.R

@@ -9,18 +9,6 @@
 #' good place for roxygen directives that apply to the whole package (vs. a
 #' specific function), such as global namespace tags like `@importFrom`.
 #'
-#' There is one tricky case: when a **package** named "foo" also has a
-#' **function** named `foo()`. In this case, after running `use_package_doc()`,
-#' there will be an `R CMD check` warning. The solution is to set the `@aliases`
-#' for the package-level help topic by modifying the dummy `.R` file (e.g.,
-#' `foo-package.R`) as shown below (but substitute the name of your package /
-#' function for "foo"):
-#'
-#' ```
-#' #' @keywords internal
-#' #' @aliases foo-package
-#' #' "_PACKAGE"
-#' ```
 #' @seealso The [documentation chapter](https://r-pkgs.org/man.html) of [R
 #'   Packages](https://r-pkgs.org)
 #' @inheritParams use_template