improve terminology for local versions, revisions, etc.

[michielbdejong]

trafficstars

• [ ] discuss, see http://community.remotestorage.io/t/improve-terminology-for-local-versions-revisions-etc/190
• [ ] apply consistently

[raucao]

Also, document the terms.

[michielbdejong]

Yep, good point

[michielbdejong]

from memory, the most important part was:

local/remote store - remoteStorage.local/remoteStorage.remote

local/remote/common/push/latest version - corresponding version in a node as it's handled in sync and autoMerge, and stored in the local store. (latestVersion is the local version if it exists, the common version otherwise).

revision - the ETag string (so don't call a "version" a "revision")

[michielbdejong]

so you for instance can talk about "the revision of the remote version that is currently in the local store". :)

[michielbdejong]

ah, and 'node' is the collection of versions for one folder or document, as stored locally and/or moved around and processed by sync and autoMerge