doc: update manage data section

This commit is contained in:
Swann 2020-06-22 11:02:58 +02:00
parent 661065e51f
commit 3d9c20cc03
No known key found for this signature in database
GPG Key ID: 5E0D936BD280E963
3 changed files with 37 additions and 6 deletions

View File

@ -44,7 +44,7 @@ All notable changes to this project will be documented in this file.
- Auto updater support
- Performances improvements on Meshes, Gpencils, Actions
- Multi-scene workflow support
- Render setting synchronisation
- Render setting synchronization
- Kick command
### Changed

View File

@ -51,3 +51,9 @@ Glossary
+--------------------+---------------------------------------------------------------------------------------------+
.. _common-right:
common right
When a data block is under common right, it is available for everyone to modification.
The rights will be given to the user that select it first.

View File

@ -93,6 +93,9 @@ It will do two things:
* Start a local server
* Connect you to it as an :ref:`admin`
During online session, various actions are available to you, go to :ref:`how-to-manage` section to
learn more about them.
.. _how-to-join:
How to join a session
@ -205,8 +208,8 @@ Kick a user
The **CROSS button** (Also called **kick** operator) allow the admin to kick the selected user. On the target user side, the session will properly disconnect.
--------------------
Manage users display
Change users display
--------------------
Presence is the multi-user module responsible for users display. During the session,
@ -228,9 +231,31 @@ various drawn parts via the following flags:
- **Show users**: display users current viewpoint
- **Show different scenes**: display users working on other scenes
----------------------
Manage replicated data
----------------------
-----------
Manage data
-----------
In order to understand replication data managment, a quick introduction to the multi-user data workflow is required.
First thing to know: until now, the addon rely on a data-based replication. In simple words, it means that it replicate
user's action results.
To replicate datablocks between clients the multi-user rely on what tends to be a distributed architecture:
- The server store the "master" version of the work.
- Each client have a local version of the work.
When an artist modified something in the scene, here is what is happening in the background:
1. Modified data are **COMMITTED** to the local repository.
2. Once committed locally, they are **PUSHED** to the server
3. As soon as the server is getting updates, they are stored locally and pushed to every other clients
At the top of this data management system, a right management system prevent
multiple users from modifying same data at same time. A datablock may belong to
a connected user or be under :ref:`common-right<**COMMON**>` rights.
.. note::
In a near future, the right management system will support roles to allow multiple users to
work on different aspect of the same datablock.
.. figure:: img/quickstart_properties.png
:align: center