Fix issue #1298: CLI help out of date

CHANGELOG.md

@@ -2,10 +2,11 @@ Changelog
 =========
 
 NOTE: isort follows the [semver](https://semver.org/) versioning standard.
-### 5.0.5 July 6, 2020
+### 5.0.5 July 7, 2020
   - Fixed #1285: packaging issue with bundling tests via poetry.
   - Fixed #1284: Regression when sorting `.pyi` files from CLI using black profile.
   - Fixed #1275 & #1283: Blank line after docstring removed.
+  - Fixed #1298: CLI Help out of date with isort 5.
 
 ### 5.0.4 July 6, 2020
   - Fixed #1264: a regression with comment handling and `force_sort_within_sections` config option

isort/main.py

@@ -129,9 +129,13 @@ def iter_source_code(paths: Iterable[str], config: Config, skipped: List[str]) -
 def _build_arg_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         description="Sort Python import definitions alphabetically "
-        "within logical sections. Run with no arguments to run "
-        "interactively. Run with `-` as the first argument to read from "
-        "stdin. Otherwise provide a list of files to sort."
+        "within logical sections. Run with no arguments to see a quick "
+        "start guide, otherwise, one or more files/directories/stdin must be provided. "
+        "Use `-` as the first argument to represent stdin. Use --interactive to use the pre 5.0.0 "
+        "interactive behavior."
+        ""
+        "If you've used isort 4 but are new to isort 5, see the upgrading guide:"
+        "https://timothycrosley.github.io/isort/docs/upgrade_guides/5.0.0/."
     )
     inline_args_group = parser.add_mutually_exclusive_group()
     parser.add_argument(