|
This quick start guide is provided to help
you get basic sync operations configured.
BEFORE YOU GET
STARTED
|
 |
**
PLEASE READ THIS BEFORE PROCEEDING WITH SYNCING
***
FIRST:
Make a
backup of your local files you plan to sync with
Google Documents. You can also export
your data from Google documents as well. This
way as you work through how you want KumoSync to
sync
your local folders with Google documents you
will not lose any files.
SECOND:
Many may notice that in Google Documents there
are groupings called "collections" which
appear to function like a typical folder. These
"collections" are not like local file folders
and work like tags or categories used as a way
to group or classify your documents.
A
single Google document can exist in multiple
collections whereas on the local file system this is
not possible; the same file would need to exist as a
_copy_ in each of the local folders.
COLLECTIONS ARE
NOT LIKE FOLDERS
If you look at how
Google Documents is organized it is really
just a single list of files without a "directory"
type structure. Google Documents provide a way
to create collections structure as a way to
organize your documents into groups allowing a
single document to be referenced by multiple
collections. Obviously, this is very different
from how a traditional local file system
works.
Additionally, Google Document's allows for
multiple documents with the SAME NAME to exist
in the same collection. This again is something
that a traditional local file system does not
allow. This furthers the complexity and
challenge of syncing Google Documents to a local file/directory
structure.
During development of
KumoSync we found that attempting to mimic the
Google document collection structure as a local
file structure was quite problematic and would
likely be confusing for many users. It was also
very confusing to us which is why we are writing
this!

We suggest syncing
with the "all items" Google Document list
with a specific local folder or syncing with a
specific Google document collection with a
specific local folder. This is the simplest
approach to syncing and has the least amount of
complexity.
It is possible to sync
local subfolders with Google Document
collections by enabling the option to sync
sub-folders/collections. It's important to take
note that Google Documents allows for multiple
documents with the same name and the same
document can exist in multiple collections.
Local file systems do not support either of
these cases.
CONFIGURING THE
SYNC PROCESS
|
 |
|