а вот пример command-line интерфейса, для разнообразия. У brew (пакетный менеджер для mac) есть две команды: update и upgrade. Одна из них обновляет сам brew, а другая — указанный пакет. Запомнить это, естественно, никакой возможности нет, потому что логики нет. Т.е. можно придумать какой-то слабый аргумент, почему одно — это одно, а другое — другое, но штука со слабыми аргументами в том, что они никого не колышат кроме автора в момент придумывания. В целом это слова синонимы, как Options, Settings и Preferences, и это никак не починить.
Что же делать? Ведь команды действительно обе нужны, и обе важны. Как их назвать, чтобы было понятно? Беспрецендентный случай в данном канале: у проблемы есть хорошее решение и я его назову! Для обновления самого brew, а не пакета, нужно использовать команду brew upgrade brew.