fmease / lushui

The reference compiler of the Lushui programming language
Apache License 2.0
5 stars 0 forks source link

Rename capsules to components and `capsule` to `topmost` #128

Closed fmease closed 2 years ago

fmease commented 2 years ago

Even though I really like that the common meaning of the word capsule really fits our meaning (see Merriam-Webster), the word itself sounds unpleasant in my ears and I feel like it has too many connotations with medical pills. I believe that don't think of an abstract entity when they first hear the word capsule (just like with crate which is why I don't like that one either).

I thought about using the word component when researching words to replace crate. I didn't like it though partially because I thought we would have to rename the keyword crate to component which is a bit too long in my opinion. Just now, I saw Haskell's Cabal uses the term component for this concept (docs).

As for the keyword, I suggest topmost (the root (module) of a component). I would've chosen root or top if it wasn't such a common word. I think topmost is reasonably more uncommon.

The root/top/topmost module is also called the component root. On the other hand, the "root" component is called the goal component (earlier "root" in the sense of the dependency graph).

Component can be further qualified as package component.