Today when a user is interested in news regarding the Git, their favorite version control, it is a challenging task to find out what is actually happening. If the user is using a Git in a distribution that packaged it nicely for them, they may find outdated information in their distribution using the distributions choice of relaying news. As Git is a fast paced project, this is not the desired behavior for most users. They rather prefer the latest news. One could argue that it is OK to expect the user to read the "What's cooking" emails or even release notes to get a grasp of the latest development of Git, but these news do not quite catch the lively atmosphere of the mailing list with all its polite flame wars and opinionated arguments on why a patch is written the way it ends up in the release notes. It is time to fix the root case of this important user facing problem in a sensible way that doesn't confuse the user. Invent a new sub command 'git-news', which presents the latest news in a way capturing all the interesting tid-bits of the mailing list as well as the surrounding ecosystem. As we're rushing the solution of this important problem, we did not consider alternatives, such that we end up solving it in a backwards compatible, but forwards incompatible way; clearly nobody in the future wants to add another command that points to different news source. This is why we can take the generic name 'git-news', instead of using the rather specialized 'git-rev-news' command that is harder to remember and type. Signed-off-by: Stefan Beller <sbeller@xxxxxxxxxx> --- .gitignore | 1 + Documentation/git.txt | 2 ++ Makefile | 1 + command-list.txt | 1 + git-news.sh | 4 ++++ 5 files changed, 9 insertions(+) create mode 100755 git-news.sh diff --git a/.gitignore b/.gitignore index 833ef3b0b7..b2d9c1161f 100644 --- a/.gitignore +++ b/.gitignore @@ -98,6 +98,7 @@ /git-mktag /git-mktree /git-name-rev +/git-news /git-mv /git-notes /git-p4 diff --git a/Documentation/git.txt b/Documentation/git.txt index ecc1bb4bd7..f4629aa39b 100644 --- a/Documentation/git.txt +++ b/Documentation/git.txt @@ -35,6 +35,8 @@ manual page gives you an overview of the command-line command syntax. A formatted and hyperlinked copy of the latest Git documentation can be viewed at `https://git.github.io/htmldocs/git.html`. +A more entertaining section of news can be obtained via `git-news`. + ifdef::stalenotes[] [NOTE] ============ diff --git a/Makefile b/Makefile index 9f8b35ad41..32e50f30a2 100644 --- a/Makefile +++ b/Makefile @@ -519,6 +519,7 @@ SCRIPT_SH += git-merge-octopus.sh SCRIPT_SH += git-merge-one-file.sh SCRIPT_SH += git-merge-resolve.sh SCRIPT_SH += git-mergetool.sh +SCRIPT_SH += git-news.sh SCRIPT_SH += git-quiltimport.sh SCRIPT_SH += git-rebase.sh SCRIPT_SH += git-remote-testgit.sh diff --git a/command-list.txt b/command-list.txt index a1fad28fd8..150b287ada 100644 --- a/command-list.txt +++ b/command-list.txt @@ -91,6 +91,7 @@ git-mktag plumbingmanipulators git-mktree plumbingmanipulators git-mv mainporcelain worktree git-name-rev plumbinginterrogators +git-news mainporcelain git-notes mainporcelain git-p4 foreignscminterface git-pack-objects plumbingmanipulators diff --git a/git-news.sh b/git-news.sh new file mode 100755 index 0000000000..1707dc633e --- /dev/null +++ b/git-news.sh @@ -0,0 +1,4 @@ +#!/bin/sh +# + +/usr/bin/sensible-browser https://git.github.io/rev_news/ -- 2.12.2.576.g7be6e4ba40.dirty