From 4c494dd94ba220035cf1c962b73bedf70fd0587f Mon Sep 17 00:00:00 2001 From: Paula-Kli Date: Mon, 27 Nov 2023 11:13:40 +0100 Subject: [PATCH] docs: Fix documentation according to user feedback --- .../settings/model-sources/git.md | 0 .../settings/model-sources/t4c.md | 0 .../{user => admin}/settings/monitoring.md | 6 ++---- .../{user => admin}/settings/tools/index.md | 4 ---- .../settings/tools/model_restrictions.png | Bin .../tools/model_restrictions.png.license | 0 .../settings/tools/model_restrictions_pv.png | Bin .../tools/model_restrictions_pv.png.license | 0 .../settings/tools/pure_variants.md | 2 +- docs/docs/user/projects/models/create.md | 12 ++++++++--- docs/docs/user/projects/models/update.md | 6 ++++-- .../user/sessions/jupyter/collaboration.md | 8 ------- .../jupyter/jupyter-collaboration.mp4 | 3 --- .../jupyter/jupyter-collaboration.mp4.license | 2 -- docs/mkdocs.yml | 20 +++++++++--------- 15 files changed, 26 insertions(+), 37 deletions(-) rename docs/docs/{user => admin}/settings/model-sources/git.md (100%) rename docs/docs/{user => admin}/settings/model-sources/t4c.md (100%) rename docs/docs/{user => admin}/settings/monitoring.md (77%) rename docs/docs/{user => admin}/settings/tools/index.md (87%) rename docs/docs/{user => admin}/settings/tools/model_restrictions.png (100%) rename docs/docs/{user => admin}/settings/tools/model_restrictions.png.license (100%) rename docs/docs/{user => admin}/settings/tools/model_restrictions_pv.png (100%) rename docs/docs/{user => admin}/settings/tools/model_restrictions_pv.png.license (100%) rename docs/docs/{user => admin}/settings/tools/pure_variants.md (92%) delete mode 100644 docs/docs/user/sessions/jupyter/jupyter-collaboration.mp4 delete mode 100644 docs/docs/user/sessions/jupyter/jupyter-collaboration.mp4.license diff --git a/docs/docs/user/settings/model-sources/git.md b/docs/docs/admin/settings/model-sources/git.md similarity index 100% rename from docs/docs/user/settings/model-sources/git.md rename to docs/docs/admin/settings/model-sources/git.md diff --git a/docs/docs/user/settings/model-sources/t4c.md b/docs/docs/admin/settings/model-sources/t4c.md similarity index 100% rename from docs/docs/user/settings/model-sources/t4c.md rename to docs/docs/admin/settings/model-sources/t4c.md diff --git a/docs/docs/user/settings/monitoring.md b/docs/docs/admin/settings/monitoring.md similarity index 77% rename from docs/docs/user/settings/monitoring.md rename to docs/docs/admin/settings/monitoring.md index e71917e0a3..7656a57c19 100644 --- a/docs/docs/user/settings/monitoring.md +++ b/docs/docs/admin/settings/monitoring.md @@ -5,9 +5,7 @@ # Pipeline and Model Modifier Monitoring - -!!! info - Only administrators can see the monitoring dashboard. - To get a general overview of the status of pipelines and model modifiers for all registered models, a monitoring dashboard is provided. + +You can find it going to `Profile` > `Settings` > `Monitoring` diff --git a/docs/docs/user/settings/tools/index.md b/docs/docs/admin/settings/tools/index.md similarity index 87% rename from docs/docs/user/settings/tools/index.md rename to docs/docs/admin/settings/tools/index.md index 15d045c48f..e810ce7f60 100644 --- a/docs/docs/user/settings/tools/index.md +++ b/docs/docs/admin/settings/tools/index.md @@ -11,10 +11,6 @@ dockerized). ## Managing Tools - -!!! warning - To manage tools, you have to be administrator. - The tool management page can be found at `Profile` > `Settings` > `Core` > `Tools`. It support the following: diff --git a/docs/docs/user/settings/tools/model_restrictions.png b/docs/docs/admin/settings/tools/model_restrictions.png similarity index 100% rename from docs/docs/user/settings/tools/model_restrictions.png rename to docs/docs/admin/settings/tools/model_restrictions.png diff --git a/docs/docs/user/settings/tools/model_restrictions.png.license b/docs/docs/admin/settings/tools/model_restrictions.png.license similarity index 100% rename from docs/docs/user/settings/tools/model_restrictions.png.license rename to docs/docs/admin/settings/tools/model_restrictions.png.license diff --git a/docs/docs/user/settings/tools/model_restrictions_pv.png b/docs/docs/admin/settings/tools/model_restrictions_pv.png similarity index 100% rename from docs/docs/user/settings/tools/model_restrictions_pv.png rename to docs/docs/admin/settings/tools/model_restrictions_pv.png diff --git a/docs/docs/user/settings/tools/model_restrictions_pv.png.license b/docs/docs/admin/settings/tools/model_restrictions_pv.png.license similarity index 100% rename from docs/docs/user/settings/tools/model_restrictions_pv.png.license rename to docs/docs/admin/settings/tools/model_restrictions_pv.png.license diff --git a/docs/docs/user/settings/tools/pure_variants.md b/docs/docs/admin/settings/tools/pure_variants.md similarity index 92% rename from docs/docs/user/settings/tools/pure_variants.md rename to docs/docs/admin/settings/tools/pure_variants.md index d94009d87c..647f574ef2 100644 --- a/docs/docs/user/settings/tools/pure_variants.md +++ b/docs/docs/admin/settings/tools/pure_variants.md @@ -17,7 +17,7 @@ !!! warning - The setup can only be performed by administrators. If you want to get access as user, please refer to [Get access to the `pure::variants` license as user](#get-access-to-the-purevariants-license-as-user) + The setup can only be performed by administrators. If a user wants to get access, please refer to [Get access to the `pure::variants` license as user](#get-access-to-the-purevariants-license-as-user) ### Set License Server URL and Upload `license.lic` diff --git a/docs/docs/user/projects/models/create.md b/docs/docs/user/projects/models/create.md index d550c57439..7e94417de0 100644 --- a/docs/docs/user/projects/models/create.md +++ b/docs/docs/user/projects/models/create.md @@ -101,6 +101,12 @@ name for the repository and project. ## Step 4: Metadata -This is an important step. Here, you can select the version and the model -nature of your tool. If you don't select any version, the functionality will be -restricted. You will not be able to setup backups or create read-only sessions. +This is an important step. + +Here, you can select the version and the model nature of your tool. If you +don't select any version, the functionality will be restricted. You will not be +able to setup backups or create read-only sessions. + +For Capella the best version to pick currently is 6.0.0. Older versions are +outdated and the possibility might to use them might be removed in the future. +Make sure your model is up to date and you update it in time. diff --git a/docs/docs/user/projects/models/update.md b/docs/docs/user/projects/models/update.md index 7631fa0cc2..329f6d24d8 100644 --- a/docs/docs/user/projects/models/update.md +++ b/docs/docs/user/projects/models/update.md @@ -12,7 +12,7 @@ !!! info - If you want to update a Capella model, please follow the Capella specific instructions instead: + If you want to update a Capella model saved in TeamForCapella, please follow the Capella specific instructions instead: [Update a TeamForCapella based Capella model](../../tools/capella/teamforcapella/update.md) 1. Open a new persistent session with the old version of your tool. @@ -20,5 +20,7 @@ 1. Close the session. 1. Remove the automatic backup option in the Capella Collaboration Manager, we'll rewire it at the end of this tutorial. -1. Create a new session with the new Capella version. +1. Create a new session with the new version of your tool. 1. Migrate the model in your local workspace. +1. Now follow [this guide](backups/setup.md) to setup the automatic backup + again diff --git a/docs/docs/user/sessions/jupyter/collaboration.md b/docs/docs/user/sessions/jupyter/collaboration.md index 3c951e943c..6bef9b281e 100644 --- a/docs/docs/user/sessions/jupyter/collaboration.md +++ b/docs/docs/user/sessions/jupyter/collaboration.md @@ -28,14 +28,6 @@ connect to your sessions, follow these steps: 6. **Share the Link**: Distribute the link to all users who should have access. They will be able to open your notebooks and concurrently edit them. -#### Instructional Video - -Here's a video that visually guides you through these steps: - - - ## Collaboration on Project Level If you need a shared workspace for notebooks at the project level, you can diff --git a/docs/docs/user/sessions/jupyter/jupyter-collaboration.mp4 b/docs/docs/user/sessions/jupyter/jupyter-collaboration.mp4 deleted file mode 100644 index efc189ab98..0000000000 --- a/docs/docs/user/sessions/jupyter/jupyter-collaboration.mp4 +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:c1eb20daddfb070885869dfff861f3a4fcd34fc8cdc196e8b3fdbd1cd9a5c7f9 -size 2285837 diff --git a/docs/docs/user/sessions/jupyter/jupyter-collaboration.mp4.license b/docs/docs/user/sessions/jupyter/jupyter-collaboration.mp4.license deleted file mode 100644 index a990c04543..0000000000 --- a/docs/docs/user/sessions/jupyter/jupyter-collaboration.mp4.license +++ /dev/null @@ -1,2 +0,0 @@ -SPDX-FileCopyrightText: Copyright DB Netz AG and the capella-collab-manager contributors -SPDX-License-Identifier: Apache-2.0 diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index bd8016ab17..f79a12ac32 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -50,16 +50,6 @@ nav: - Troubleshooting: user/sessions/troubleshooting.md - Jupyter: - Collaboration: user/sessions/jupyter/collaboration.md - - Settings: - - Monitoring: user/settings/monitoring.md - - Tools: - - General: user/settings/tools/index.md - - pure::variants: user/settings/tools/pure_variants.md - - Model sources: - - Git: user/settings/model-sources/git.md - - T4C: user/settings/model-sources/t4c.md - - Alerts: - - Create an Alert: user/alerts/create.md - Tools: - Capella: - Introduction: user/tools/capella/introduction.md @@ -78,6 +68,16 @@ nav: - Installation: admin/installation.md - Uninstallation: admin/uninstallation.md - Getting started: admin/getting_started/getting_started.md + - Settings: + - Monitoring: admin/settings/monitoring.md + - Tools: + - General: admin/settings/tools/index.md + - pure::variants: admin/settings/tools/pure_variants.md + - Model sources: + - Git: admin/settings/model-sources/git.md + - T4C: admin/settings/model-sources/t4c.md + - Alerts: + - Create an Alert: admin/alerts/create.md - CI templates: - Gitlab CI/CD: - Image builder: admin/ci-templates/gitlab/image-builder.md