app-route
app-route copied to clipboard
`carbon-route` and `route` property introduce naming ambiguity
This issue is here to facilitate discussion on an API naming topic.
The proposal is that carbon-route and the route property of same embody distinct concepts respectively, and so either carbon-route should be renamed, or route should be renamed.
Please discuss possible alternatives or arguments against the proposal in this issue!
A few disorganized thoughts:
routeis both a verb and a noun, leading to confusing sentences likeRouting is handled by passing the carbon-location's route property to the carbon-route.- However, there aren't a ton of good synonyms for
routethat would fit here. Ideally it should express a point along one path out of many.waypointis kinda in the right direction. - The standard term for the problem domain is
routing, so there's significant value in staying close to that metaphor. - I think a bunch of us, Scott, Chris, and myself at the least have spent a decent amount of time trying to come up with better naming, but without much progress.
- I think we are going to rename the
matchproperty topattern, aspatternmore clearly represents what it is, as well as being unambiguously a noun.
Interestingly, I haven't heard any feedback to this effect so far. Anyone reading this who does find the repetition of carbon-route and the route property confusing, let us know with a comment or reaction!