dandavison / delta

A syntax-highlighting pager for git, diff, grep, and blame output
https://dandavison.github.io/delta/
MIT License
22.98k stars 382 forks source link

The project name makes this very difficult to find via search #48

Closed fearphage closed 4 years ago

fearphage commented 4 years ago

Since deltas have meaning in a git context, searching for this project with keywords like github, git, delta, and download makes this project almost impossible to find. I had to give up and ask someone to link me to it. It would be nice to make this more discoverable.

FYI there is a (seemingly unmaintained) ruby gem named git-delta that I found, but I still couldn't Google my way to this repo.

joshka commented 4 years ago

+1 on this - I found git-delta via seeing it in the list of updated tools in homebrew, but then tried to find it from my work computer via google the next day and was a little stymied.

dandavison commented 4 years ago

Hm, yes maybe I didn't choose well! Thanks for the feedback, I wonder what's the best course at this stage. I did try adding git-delta to the "topics" of the github repo when you first opened this issue @fearphage; not sure if it's helped. It looks like including the term "pager" (or "syntax-highlighting") in google searches does find it currently. But sadly this issue can't be solved by suggesting to people how to search :) Open to suggestions, it's already annoying that "delta" was taken in homebrew and apt-get package repositories, so I had to turn to "git-delta" as a package name. Maybe a more googleable package name while retaining the "delta" executable name. Or hope for more popularity and thus to eventually prevail with the search engines... not sure!

joshka commented 4 years ago

Perhaps rename it ddelta or ddiff or something else as a play on your name.

drhayes commented 4 years ago

Just throwing out suggestions:

:man_shrugging:

tmccombs commented 4 years ago

a couple more suggestions:

ELLIOTTCABLE commented 4 years ago

deltalowda.

source

dandavison commented 4 years ago

Thanks for the feedback everyone. I don't feel comfortable changing the name now that it's in users' gitconfigs etc. I think I'm just going to to accept that I made a questionable choice, which is hard to google, and preventing it getting into Debian... we'll have to see if delta can battle through despite that!

tmccombs commented 4 years ago

I don't feel comfortable changing the name now that it's in users' gitconfigs etc.

I respect that decision. But I would like to point out that the project name and the command name don't have to be identical. For example the silver searcher and ripgrep use ag and rg as their commands respectively. Also, while there is a "delta" package in debian, it conveniently doesn't have any executable named "delta", so if the package name was different I don't think there would be any problem with having the executable called "delta" in the debian package.

dandavison commented 4 years ago

Thanks @tmccombs. That's what I'm aiming for also: package name git-delta, installing executable delta. That's how it is with Homebrew, Rust Cargo, Archlinux, FreeBSD. Unfortunately Debian is not going completely smoothly. You can read the packaging RFS thread at https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=946213

Also, while there is a "delta" package in debian, it conveniently doesn't have any executable named "delta",

While that's true, it would appear that another package does install an executable named "delta": https://tracker.debian.org/pkg/swap-cwm I don't think that executable is widely used though.

Maybe I shouldn't have closed this issue, I'm very much appreciating the discussion and suggestions. I'm currently thinking that I want the executable name to remain "delta" since that's what the docs have always said and that's what we have in our config files. I'll reopen!

dandavison commented 4 years ago

Closing this again :) The project seems to be coming up on the first page now for reasonable search terms in the engines/browsers I'm trying. I'll try to get it included in Debian as package=git-delta, executable=git-delta.