On Wed, Apr 16, 2014 at 1:05 PM, Patrick Ohly <[email protected]>wrote:
> On Wed, 2014-04-16 at 19:43 +0200, Emiliano Heyns wrote: > > More specifically, I think we need to converge, not diverge the > > terminology. I *have* diverted from the existing syncevolution > > terminology where I think they suggest commonality where there is > > none; perhaps the technical implementation of the configuration of > > target-config and sync config share code, but if my understanding of > > them is correct, their behavior is non-trivially different, and that I > > have reflected in new naming. > I agree that terminology (and concepts) should come first. One thing I was attempting to do with my post was to find a minimal set of terminology/concepts that would suffice to explain what SE does and then introduce it in a "cumulative" way with a minimum of forward references, the same way that mathematical texts or formal specifications proceed. That reduces the burden on someone trying to understand SE by giving them a path through the concepts that they can follow from beginning to end. I realize that that will not always be possible, but I think it should be a goal. Regarding converging: we can follow two approaches or perhaps phases. > > First we reach consensus on key terms. [...] > > The next phase then would be to pick the exact wording for README.rst, > using these agreed terms. We should do this using git commits in actual > repos, to facilitate merging and change tracking. [...] > +1 and +1 > Regarding the new terms, here's my position: > > +1 for "originating source". I think it is needed. > > +1 for "store" instead of "source". I agree with Todd's explanation that > the source incorrectly implies a data direction. > > -1 for "Client Endpoints". This is misleading because the same thing is > also needed for servers. "sync config" covers both because it is > neutral. > > -1 "Synced stores". This just doesn't sound right to me, but I cannot > quite nail why. Perhaps because I simply don't think of this as real > entities, just as some additional settings for a source (or soon, > store). > I want to do more work trying to understand SE as it is before I offer my position. I've been reading Emiliano's helpful document, and will keep making passes through that and your README until my understanding converges. Then I'll see if I can document that understanding in a "cumulative" way, starting from first principles, with a minimum of forward references. --Todd
_______________________________________________ SyncEvolution mailing list [email protected] https://lists.syncevolution.org/mailman/listinfo/syncevolution
