On Wed, Apr 16, 2014 at 1:05 PM, Patrick Ohly <patrick.ohly@intel.com> 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