From 3c5151aff82b8d2393ce21cdf70a131e0bd0e47e Mon Sep 17 00:00:00 2001 From: MoritzWeber Date: Sat, 21 Sep 2024 13:11:35 +0200 Subject: [PATCH] docs: Add comparision between local Capella and Collaboration Manager --- .../local-installation-vs-collab-mgr.md | 78 +++++++++++++++++++ .../user/tools/capella/t4c-git-compare.md | 2 +- docs/mkdocs.yml | 1 + 3 files changed, 80 insertions(+), 1 deletion(-) create mode 100644 docs/docs/user/tools/capella/local-installation-vs-collab-mgr.md diff --git a/docs/docs/user/tools/capella/local-installation-vs-collab-mgr.md b/docs/docs/user/tools/capella/local-installation-vs-collab-mgr.md new file mode 100644 index 000000000..54efb1832 --- /dev/null +++ b/docs/docs/user/tools/capella/local-installation-vs-collab-mgr.md @@ -0,0 +1,78 @@ + + +# Difference between a local installation and the Capella Collaboration Manager + +You may have thought about why you should use the Capella Collaboration Manager +and not just a local Capella installation. It depends on a variety of factors, +so here is a decision help: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Local Capella InstallationCapella Collaboration Manager
Differences between operating systemsWhen the team uses different operating systems or dependencies, there may be small differences in the Capella behaviour. Bugs have to be collected and reported for each OS individully. In addition, it's important that all users use the same font, otherwise diagrams will change on each save when a new font is applied. Diagrams might look different on different devices.All sessions run on Linux in a Docker container with exactly the same dependencies. Bugs are easier to reproduce.
ConfigurationManual configuration by users. Some configuration options have to be aligned in the team.Pre-defined configuration according to best-practises and experience. Users may deviate from the central configuration via modifications in their personal workspace.
PerformanceNative Capella performance, no latency in local projects.Performance depends on the internet connection and latency.
BackupsUnless saved on a remote server like TeamForCapella or Git, changes have to be backed up manually.Workspaces can be backed up regularly (this service might not be enabled for all environments).
Offline workingOffline working possible with local models or with the Git workflow. Not possible with TeamForCapella.Access via browser with active internet connection. Working offline is not possible at the moment.
Installation effortSoftware, plugins, dependencies and dropins have to be installed and updated manually.Everything is installed centrally and managed by the System Administrators.
Working together in one Capella instanceRequires external software for screen sharing.Natively integrated with session sharing. You can see other users' pointers and collaborate interactively.
Task automationTasks can be automated using `capellambse` and `capellambse-context-diagrams` locally. Python, dependencies and packages have to be installed manually.Native integration of Jupyter with the latest versions of `capellambse` and `capellambse-context-diagrams` preinstalled.
Support effortHigh effort to support installation on many different devices. Workspaces and logs are not accessible centrally.Central log collection and installation. For debug purposes, workspace can be accessed by System Administrators.
Access managementAccess has to be managed centrally, either manually on the TeamForCapella server or via AD groups.Access is self-managed by project administrators.
Support for read-only sessionsUsers consume licenses in TeamForCapella projects for read-access. Changes to the model are not prohibited.All changes to models in read-only sessions are discarded. No license is needed for read-only sessions.
Monitoring capabilitiesMonitoring has to be built manually.Monitoring of TeamForCapella repositories, license usage and usage of different tools / versions.
diff --git a/docs/docs/user/tools/capella/t4c-git-compare.md b/docs/docs/user/tools/capella/t4c-git-compare.md index b43aee6b9..1c4d3e9ff 100644 --- a/docs/docs/user/tools/capella/t4c-git-compare.md +++ b/docs/docs/user/tools/capella/t4c-git-compare.md @@ -20,7 +20,7 @@ Concurrent working - Very challenging because of merge conflict potential. + Very challenging because of merge conflict potential, a possible workflow is described [here](./git/index.md). Is possible. Diagrams are locked, no risk of merge conflicts. diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index cebc7274a..c61569713 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -55,6 +55,7 @@ nav: - Introduction: user/tools/capella/introduction.md - Update a Capella Model to a Newer Version: user/tools/capella/migration/index.md - Co-working Methods: user/tools/capella/t4c-git-compare.md + - Local Capella vs. Collaboration Manager: user/tools/capella/local-installation-vs-collab-mgr.md - TeamForCapella: - Connect to a TeamForCapella Repository: user/tools/capella/teamforcapella/connect/index.md - Import a Model from TeamForCapella: user/tools/capella/teamforcapella/import/index.md