fastmod icon indicating copy to clipboard operation
fastmod copied to clipboard

Sane repository description

Open abitrolly opened this issue 2 years ago • 3 comments

Add "find and replace tool" into repository description. Otherwise there is absolutely no way for search algorithms to discover the tool. And add some topics there like https://github.com/topics/find-and-replace https://github.com/topics/find and https://github.com/topics/replace

abitrolly avatar Dec 20 '23 17:12 abitrolly

I would agree, most people don't know what codemod is. Far more people could use this tool than presently have heard of it. I think I learned of it via ChatGPT, but most people are going to be searching for some key words.

A more search-friendly repo description could be: "Search and replace regex strings across many files interactively." This description is even more important on package managers like Homebrew. There, the same inscrutable description exists, but without any of the README context—and there isn't even a codemod formula to give you a clue.

nk9 avatar Sep 28 '25 04:09 nk9

Updated the description, partly based on the codemod tool's description. What do you think?

swolchok avatar Sep 29 '25 16:09 swolchok

@swolchok I find references for codemod most confusing. From what I see fastmod is a standalone tool, not some "fast partial replacement" add-on for codemod.

For the description it would be sufficient to say that "fastmod is interactive bulk search/replace tool" and then expand in README that it is based on codemod and explain differences between two.

Personally, I would explain fastmod as a "missing replace for ripgrep". And add terminal to the list of repo topics.

abitrolly avatar Sep 29 '25 17:09 abitrolly