opral / inlang-sdk

0 stars 0 forks source link

`target & source` -> `target & incoming` #139

Closed samuelstroschein closed 2 weeks ago

samuelstroschein commented 2 months ago

Context

Source can be confusing.

Is source where the changes are coming from or where changes are merged into?

Proposal

Use incoming instead of source.

"Incoming changes are merged into the target"

samuelstroschein commented 2 months ago

cc @jannes.blobel who proposed this

samuelstroschein commented 2 months ago

One problem is increased ambiguity for expressing that changes only exist in X. Source & Target might as well be just fine. Incoming is an interpretation of what the source (of changes) is that should be merged with target.

commonChanges
changesOnlyInSource
changesOnlyInTarget 
commonChanges
incomingChanges // amibigious. what are incoming changes? 
targetChanges
commonChanges
changesOnlyInIncoming // ugly
changesOnlyInTarget
samuelstroschein commented 2 weeks ago

tbh terminology is good enough