From 29c8cdd261039dda4e1b12864b8185d0cdbcb339 Mon Sep 17 00:00:00 2001 From: Daira Hopwood Date: Wed, 20 May 2015 00:28:03 +0100 Subject: [PATCH] remote-to-local-sync.rst: improvements to table. Signed-off-by: Daira Hopwood --- .../magic-folder/remote-to-local-sync.rst | 79 ++++++++++--------- 1 file changed, 43 insertions(+), 36 deletions(-) diff --git a/docs/proposed/magic-folder/remote-to-local-sync.rst b/docs/proposed/magic-folder/remote-to-local-sync.rst index 859dc532..63ece7f5 100644 --- a/docs/proposed/magic-folder/remote-to-local-sync.rst +++ b/docs/proposed/magic-folder/remote-to-local-sync.rst @@ -108,42 +108,49 @@ express this as a table with the properties as rows and the designs as columns. It may be useful to simplify/merge some of the properties and use footnotes for more detailed explanation.] -Key: -++ major advantage -+ minor advantage -- minor disadvantage --- major disadvantage ---- showstopper - -+------------------------------------------------+-----------------------+ -| Design Property | Designs Proposed | -+================================================+===+===+===+===+===+===+ -| **advantages** | 1 | 2 | 3 | 4 | 5 | 6 | -+------------------------------------------------+---+---+---+---+---+---+ -| Compatible with garbage collection |\+ |\+ |\+ |\+ |\+ |\+ | -+------------------------------------------------+---+---+---+---+---+---+ -| Does not break old clients |\+ |\+ |\+ |\+ |\+ |\+ | -+------------------------------------------------+---+---+---+---+---+---+ -| Allows direct sharing | | | |\+ |\+ |\+ | -+------------------------------------------------+---+---+---+---+---+---+ -| Efficient use of bandwidth |\+ | |\+ | |\+ | | -+------------------------------------------------+---+---+---+---+---+---+ -| No repeated changes |\+ |\+ |\+ | | |\+ | -+------------------------------------------------+---+---+---+---+---+---+ -| **disadvantages** | 1 | 2 | 3 | 4 | 5 | 6 | -+------------------------------------------------+---+---+---+---+---+---+ -| Can result in large DMDs |\- | | | | | | -+------------------------------------------------+---+---+---+---+---+---+ -| Must traverse immutable directory structure | | |\- | |\- | | -+------------------------------------------------+---+---+---+---+---+---+ -| Must traverse mutable directory structure | |\- | |\- | | | -+------------------------------------------------+---+---+---+---+---+---+ -| Must suppress duplicate representation changes | | | |\- |\- | | -+------------------------------------------------+---+---+---+---+---+---+ -| "Out of sync" problem | | | |\- |\- | | -+------------------------------------------------+---+---+---+---+---+---+ -| Unsolved design problems | | | | | |\- | -+------------------------------------------------+---+---+---+---+---+---+ ++---------------------------+ +| Key | ++======+====================+ +|\+\+ | major advantage | ++------+--------------------+ +|\+ | minor advantage | ++------+--------------------+ +|\- | minor disadvantage | ++------+--------------------+ +|\-\- | major disadvantage | ++------+--------------------+ +|\-\-\-| showstopper | ++------+--------------------+ + ++------------------------------------------------+-----------------------------------------+ +| Design Property | Designs Proposed | ++================================================+======+======+======+======+======+======+ +| **advantages** | 1 | 2 | 3 | 4 | 5 | 6 | ++------------------------------------------------+------+------+------+------+------+------+ +| Compatible with garbage collection |\+ |\+ |\+ |\+ |\+ |\+ | ++------------------------------------------------+------+------+------+------+------+------+ +| Does not break old clients |\+ |\+ |\+ |\+ |\+ |\+ | ++------------------------------------------------+------+------+------+------+------+------+ +| Allows direct sharing | | | |\+\+ |\+\+ |\+\+ | ++------------------------------------------------+------+------+------+------+------+------+ +| Efficient use of bandwidth |\+ | |\+ | |\+ | | ++------------------------------------------------+------+------+------+------+------+------+ +| No repeated changes |\+ |\+ |\+ | | |\+ | ++------------------------------------------------+------+------+------+------+------+------+ +| **disadvantages** | 1 | 2 | 3 | 4 | 5 | 6 | ++------------------------------------------------+------+------+------+------+------+------+ +| Can result in large DMDs |\- | | | | | | ++------------------------------------------------+------+------+------+------+------+------+ +| Must traverse immutable directory structure | | |\- | |\- | | ++------------------------------------------------+------+------+------+------+------+------+ +| Must traverse mutable directory structure | |\- | |\- | | | ++------------------------------------------------+------+------+------+------+------+------+ +| Must suppress duplicate representation changes | | | |\- |\- | | ++------------------------------------------------+------+------+------+------+------+------+ +| "Out of sync" problem | | | |\- |\- | | ++------------------------------------------------+------+------+------+------+------+------+ +| Unsolved design problems | | | | | |\-\-\-| ++------------------------------------------------+------+------+------+------+------+------+ 123456+: All designs have the property that a recursive add-lease -- 2.45.2