Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Proposal: Rename the project "aqua" #881

Closed
Tracked by #101
suzuki-shunsuke opened this issue Jun 17, 2022 · 29 comments
Closed
Tracked by #101

Proposal: Rename the project "aqua" #881

suzuki-shunsuke opened this issue Jun 17, 2022 · 29 comments

Comments

@suzuki-shunsuke
Copy link
Member

suzuki-shunsuke commented Jun 17, 2022

Feature Overview

Rename the project aqua.

Why is the change needed?

Please explain the problem you want to solve.

The googleability of aqua is low, so it is difficult to search the information about aqua using Google or another similar Internet search engine.

Does the change include Breaking Changes?

Yes. You have to fix codes.

  • aqua
  • aqua-installer
  • aqua-renovate-config

  • aqua.yaml
  • GitHub Actions
  • renovate.json
  • install scripts
@suzuki-shunsuke
Copy link
Member Author

I have no idea of new name yet.

@4513ECHO
Copy link
Contributor

How about 'turquoise' ( synonym of aqua ) or 'suiteki' ( aqua in Japanese ) ?
I may not good at be naming, but these is some ways of thinking.

@suzuki-shunsuke
Copy link
Member Author

Thank you for your proposal.

@suzuki-shunsuke
Copy link
Member Author

suzuki-shunsuke commented Jun 21, 2022

I would like to keep names of GitHub Organization, Repository, and command.
So how about combining any word and Aqua?


  • Homebrew: brew
  • cue-lang: cue

@suzuki-shunsuke
Copy link
Member Author

suzuki-shunsuke commented Jun 24, 2022

I would like to keep names of GitHub Organization, Repository, and command.
So how about combining any word and Aqua?

I changed my mind.
I don't stick to the original name "aqua".

clisvm looks unique.

https://twitter.com/search?q=clisvm&src=typed_query&f=live
https://www.google.co.jp/search?q=clisvm
https://github.com/search?q=clisvm&type=repositories

@suzuki-shunsuke
Copy link
Member Author

suzuki-shunsuke commented Jun 24, 2022

@suzuki-shunsuke
Copy link
Member Author

suzuki-shunsuke commented Jun 26, 2022

@suzuki-shunsuke
Copy link
Member Author

suzuki-shunsuke commented Jun 27, 2022

Open PRs

Create the migration script

  • Create the migration script

Publish the migration guide

  • GitHub Issue

Rename Organizations

  • Rename Organizations

Rename repositories

  • aqua
  • aqua-registry
  • aqua-installer
  • aqua-renovate-config
  • aquaproj.github.io
  • circleci-orb-aqua
  • homebrew-aqua
  • aqua-proxy
  • test-aqua-renovate-config

Create releases

  • aqua-proxy
  • aqua
  • aqua-registry
  • aqua-installer
  • aqua-renovate-config
  • circleci-orb-aqua

DocSearch

  • Investigate what to do

This was referenced Jun 27, 2022
@suzuki-shunsuke
Copy link
Member Author

suzuki-shunsuke commented Jun 27, 2022

#!/usr/bin/env bash

set -eux
set -o pipefail

git_replace() {
  git grep -l "$1" | xargs -n 1 gsed -i "s|$1|$2|g"
}

git_replace aquaproj-aqua clivm
git_replace aquaproj clivm
git_replace AQUA CLIVM
git_replace aqua clivm

@suzuki-shunsuke
Copy link
Member Author

@suzuki-shunsuke
Copy link
Member Author

@suzuki-shunsuke
Copy link
Member Author

@suzuki-shunsuke
Copy link
Member Author

suzuki-shunsuke commented Jun 27, 2022

Migration Guide

Laptop

Repository

  • Replace words
    • aquaproj-aqua: clivm
    • aquaproj: clivm
    • AQUA: CLIVM
    • aqua: clivm
  • Rename files
    • aqua.yaml: clivm.yaml

@suzuki-shunsuke
Copy link
Member Author

suzuki-shunsuke commented Jun 27, 2022

[DRAFT] Announcement: aqua will be renamed to clivm

⚠️ The announcement is still draft.

The project aqua will be renamed to clivm, because the word aqua is so common that the googleability of aqua is low.
It is difficult to search the information about aqua using Google or another similar Internet search engine.

By renaming aqua to more unique name, the googleability of this project will be improved.

We will change the following things.

  • Rename the project name aqua to clivm
  • Rename GitHub Organizations aquaproj to clivm
  • Rename GitHub Repositories under aquaproj: e.g. Rename aqua-installer to clivm-installer
  • Change the official website URL https://aquaproj.github.io to https://clivm.github.io
  • Change the CLI names
    • aqua => clivm
    • aqua-installer => clivm-installer
    • aqua-proxy => clivm-proxy
  • Change the default root directory AQUA_ROOT_DIR
    • linux and macOS: ${XDG_DATA_HOME:-$HOME/.local/share}/aquaproj-aqua => ${XDG_DATA_HOME:-$HOME/.local/share}/clivm
    • windows: ${HOME/AppData/Local}/aquaproj-aqua => ${HOME/AppData/Local}/clivm
  • Change the prefix of environment variable names from AQUA_ to CLIVM_
    • e.g. AQUA_ROOT_DIR => CLIVM_ROOT_DIR
  • Rename configuration files: \.?aqua\.ya?ml => \.?clivm\.ya?ml

What should you do?

Laptop

Repository

  • Replace words
    • aquaproj-aqua: clivm
    • aquaproj: clivm
    • AQUA: CLIVM
    • aqua: clivm
  • Rename files
    • \.?aqua\.ya?ml => \.?clivm\.ya?ml

e.g. suzuki-shunsuke/tfcmt#345

@4513ECHO
Copy link
Contributor

4513ECHO commented Jun 27, 2022

I'm sorry for late, but I'm going to write my opinion for this proposal as a mere user.
We should rename it. It's not good that the googlability is low. And the googlability of aqua is actually low.

On the other hand, I like the atmosphere of the name of aqua.
I also like the aqua logo. One of the reason why I started using aqua is not only the declarative convenience but also the name.

clivm is a name that only represents features and is too tasteless.

The coined word has higher googlability than abbreviation. I suggest aqucliva. It's a word that mixes aqua and cli. It's unique, and I think the atmosphere of the original name is maintained.

https://twitter.com/search?q=aqucliva&src=typed_query&f=live
https://www.google.co.jp/search?q=aqucliva
https://github.com/search?q=aqucliva&type=repositories

What do you think?

@suzuki-shunsuke
Copy link
Member Author

suzuki-shunsuke commented Jun 27, 2022

Thank you for your opinion.

We should rename it. It's not good that the googlability is low. And the googlability of aqua is actually low.

On the other hand, I like the atmosphere of the name of aqua.
I also like the aqua logo. One of the reason why I started using aqua is not only the declarative convenience but also the name.

clivm is a name that only represents features and is too tasteless.

The coined word has higher googlability than abbreviation.

I agree you.
I also like the atmosphere of the name of aqua and logo.

aqucliva looks cool, but I have two concerns about aqucliva.

  1. It is a little long. Long name is not desirable for typing. But maybe this is not so import, because users can set the alias freely and there are CLI tools whose name are longer than aqucliva. e.g. terraform, terrascan
  2. I can't guess the pronunciation of aqucliva

@suzuki-shunsuke
Copy link
Member Author

I reconsidered new names related to aqua, but I think clivm is better than them.
clivm may be tasteless, but it is short, unique, and easy to remember.

I really appreciate your opinion, and I'm sorry that I can't adopt your proposal.
I'm glad that you like aqua's name and logo.
I also like them.

Thank you for your proposal.

@tadayosi
Copy link
Contributor

tadayosi commented Jun 29, 2022

To me renaming to either of aquacli, aquaclivm, and aquavm seems to be enough. And I'd prefer keeping the rest of config files and env var names as-is.

But of course I always respect the owner's preference and decision. Thanks for providing us with this great tool!

@suzuki-shunsuke
Copy link
Member Author

Thank you for your opinion.

aquaclivm is a little too long.
aquavm could be nice.

It is hard to make a decision 😥

aquacli

https://www.google.co.jp/search?q=aquacli
https://twitter.com/search?q=aquacli
https://github.com/search?q=aquacli

aquaclivm

https://www.google.co.jp/search?q=aquaclivm
https://twitter.com/search?q=aquaclivm
https://github.com/search?q=aquaclivm

aquavm

https://www.google.co.jp/search?q=aquavm
https://twitter.com/search?q=aquavm
https://github.com/search?q=aquavm

⚠️ There is already a project aquavm. https://github.com/fluencelabs/aquavm

@suzuki-shunsuke
Copy link
Member Author

If we rename aqua to aquavm, we may only have to update document, and could keep the command name, GitHub Organization and Repository names, the official website URL, environment variables, configuration file names, and so on.

@suzuki-shunsuke
Copy link
Member Author

If we rename aqua to aquavm, we may only have to update document, and could keep the command name, GitHub Organization and Repository names, the official website URL, environment variables, configuration file names, and so on.

Hmm... Maybe this repository aquaproj/aqua should be renamed to aquavm?

@suzuki-shunsuke
Copy link
Member Author

👍 aquavm 2,080
👎 Aqua VM 29,100,000

image

--

image

@suzuki-shunsuke suzuki-shunsuke pinned this issue Jul 1, 2022
@takumin
Copy link

takumin commented Jul 1, 2022

How about aquamgr?

https://www.google.co.jp/search?q=aquamgr
https://twitter.com/search?q=aquamgr
https://github.com/search?q=aquamgr

Thank you very much for this great tool!

@budimanjojo
Copy link

budimanjojo commented Jul 2, 2022

What if you rename the GH organization to aquavm/aqua? Does that work?
Or maybe even better: aquavm/aqua-cli

@JJGadgets
Copy link

How about aquapkg? Gets the point across that Aqua deals with packages, and not as awkward to say to other people/out loud.

@suzuki-shunsuke suzuki-shunsuke unpinned this issue Oct 18, 2022
@Gowiem
Copy link

Gowiem commented Jul 20, 2023

Just stumbled upon this. I like the name aqua and don't know if googleability is the biggest issue I would be concerned with. Getting the word out more seems like it would be more important than a big rename migration? Just my humble opinion.

@suzuki-shunsuke
Copy link
Member Author

suzuki-shunsuke commented Jul 21, 2023

Dear folks,

Thank you for your opinion.
I close this issue because I decided not to rename the project now.
I apologize for wonderful names you have come up with.

aqua is now used by more users and projects than ever before, so I don't want to confuse users by renaming this project.

I'd like to consider how to raise awareness of this project instead.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

7 participants