diff --git a/src/editor/simple/about.html b/src/editor/simple/about.html index 40d9df347..19a264a01 100644 --- a/src/editor/simple/about.html +++ b/src/editor/simple/about.html @@ -150,14 +150,50 @@ Error checks: strings can be entered. -

Testing grammars

+

Compiling and testing grammars

-By pressing the Upload button, a grammar can be uploaded to -the GF server. -It will then be compiled with GF, and any errors not detected by the editor -will be reported. If the grammar is free from errors, the user -can test the grammar by clicking on links to the online GF shell, the Minibar -or the Translation Quiz. +When pressing the Compile button, the grammar will be compiled +with GF, and any errors not detected by the editor will be reported. +If the grammar is free from errors the user can then +test the grammar by clicking on links to the online GF shell, the Minibar or +the Translation Quiz. + +

+Grammars in the +cloud

+ +While the editor normally stores grammars locally in the browser, it is also +possible to store grammars in the cloud. Grammars can be stored in the cloud +just for backup, or to accessed them from multiple devices. + +

+There is no automatic synchronization between local grammars and the cloud. +Instead, the user should press +[Cloud Upload] +to upload the grammars to the cloud, and press +[Cloud download] +to download grammars from the cloud. In both cases, complete grammars +are copied and older versions at the destination will be overwritten. +When a grammar is deleted, both the local copy and the copy in the cloud +is deleted. + +

+Each device is initially assigned to its own unique cloud. Each device can thus +have its own set of grammars that are not available on other devices. It is +also possible to merge clouds and share a common set of grammars between +multiple devices: when uploading grammars to the cloud, a link to this grammar +cloud appears. Accessing this link from another device will cause the clouds of +the two devices to be merged. After this, grammars uploaded from one of the +devices can be downloaded on the other devices. Any number devices can join the +same grammar cloud in this way. + +

+Note that while it is possible to copy grammars between +multiple devices, there is no way to merge concurrent edits from multiple +devices. If the same grammar is uploaded to the +cloud from multiple devices, the last upload wins. Thus the current +implementation is suitable for a single user switching between different +devices, but not recommended for sharing grammars between multiple users.

Future work

@@ -172,9 +208,8 @@ be possible to extend the editor to support a larger fragment of GF, to do proper error checking and make more of the existing GF shell functionality accessible directly from the editor.

-Grammars are currently stored locally in the browser, but a future version -could allow grammars to be stored "in the cloud", allowing the same grammars -to be accessed from multiple devices. +The current grammar cloud service is very primitive. In particular, it is not +suitable for multiple users developing a grammar in collaboration.

Related documents