Ondsel-Development · prokoudine · Feb 6, 2025 · Feb 6, 2025
diff --git a/docs/account-team/account-settings/index.md b/docs/account-team/account-settings/index.md
@@ -13,17 +13,13 @@ There are two ways to access account settings:
 
 1. Click on the **3 dot icon** located at the bottom of the sidebar. Then, select **Account Settings**.
 
-![Snapshot](go-to-settings-1.gif) 
-
 ---
 
 2. Alternatively, navigate to the top of the sidebar, click on the organization name, then click on the **gear** icon of your personal organization.
 
-![Snapshot](go-to-settings-2.gif) 
-
 ---
 
-All account settings are divided into three parts.
+All account settings are divided into five parts.
 
 ## Public Details
 
@@ -62,4 +58,4 @@ For each organization, you can set email notifications: whether Lens should send
 
 This settings page lists all the share links, users, organization, and workspaces that you recommended, along with a complent comment for each (where available).
 
-For more information about promoted items, please see the **Promotions** page.
+For more information about promoted items, please see the [Promotions](/docs/promotions-bookmarks/promotions/) page.
diff --git a/docs/account-team/index.md b/docs/account-team/index.md
@@ -9,4 +9,9 @@ tags:
 sidebar_position: 5
 ---
 
-This section explain how to create new organizations, add team members, create and manage workspaces.
+This section explain how to create new organizations, add team members, create and manage workspaces.
+
+- [Account hierarchy](hierarchy)
+- [Account settings](account-settings)
+- [Managing organizations](organizations)
+- [Managing workspaces](workspaces)
diff --git a/docs/account-team/organizations/create-new/index.md b/docs/account-team/organizations/create-new/index.md
@@ -1,5 +1,5 @@
 ---
-id: create-new-org
+id: org-create-new
 title: Creating a New Organization
 description: How to create a new organization in Ondsel Lens
 tags:
@@ -13,52 +13,34 @@ This guide will explain creating a new open or private organization on Ondsel Le
 
 1. To start creating a new organization, click on the three dots icon at the bottom of the sidebar where your account name is.
 
-![Snapshot](step-01.gif)
-
 ---
 
 2. Click on **Account Settings**.
 
-![Snapshot](step-02.gif)
-
 ---
 
 3. On the **Account Settings** page, switch to the **Organization Memberships** tab.
 
-![Snapshot](step-03.gif)
-
 ---
 
 4. Click the **Create Organization** button.
 
-![Snapshot](step-04.gif)
-
 ---
 
 5. Select the **Type of Organization**, open or private.
 
-![Snapshot](step-05.gif)
-
 ---
 
 6. Type the **Name** of the organization.
 
-![Snapshot](step-06.gif)
-
 ---
 
 7. Then, type the organization's **Slug**, a variation of its name used in its URL on Lens.
 
-![Snapshot](step-07.gif)
-
 ---
 
 8. Now click on **Create** to finalize creating a new organization.
 
-![Snapshot](step-08.gif) 
-
 ---
 
-This will create a new organization and open its settings for editing.
-
-![Settings of a newly created organization](new-org-settings.png)
+This will create a new organization and open its settings for editing.
diff --git a/docs/account-team/organizations/delete-org/index.md b/docs/account-team/organizations/delete-org/index.md
@@ -1,5 +1,5 @@
 ---
-id: delete-org
+id: org-delete
 title: Deleting Organizations
 description: How to delete organizations in Ondsel Lens
 tags:

diff --git a/docs/account-team/organizations/index.md b/docs/account-team/organizations/index.md
@@ -5,11 +5,13 @@ description: FIXME
 tags:
   - account
 sidebar_position: 3
+draft: true
 ---
 
 This section explains how to manage organizations on Ondsel Lens:
 
-- What types of organizations are available
-- How to create a new organization and set it up
-- How to manage users in the organization
-- How to delete an organization
+- [What types of organizations are available](types)
+- [How to create a new organization](create-new)
+- [How to manage users in the organization](manage-users)
+- [How to manage admin access to the organization](manage-admin-access)
+- [How to delete an organization](delete-org)
diff --git a/docs/account-team/organizations/manage-admin-access/index.md b/docs/account-team/organizations/manage-admin-access/index.md
@@ -1,5 +1,5 @@
 ---
-id: manage-admin-access
+id: org-manage-admin-access
 title: Managing Admin Access
 description: How to manage admin access in your organization in Ondsel Lens
 tags:
@@ -12,42 +12,32 @@ sidebar_position: 5
 
 1. To promote a user to an administrator, navigate to the **Organization Settings** page.
 
-Then, switch to the **Users** tab and locate the user you wish to promote.
+---
 
-![Snapshot](promote-01.gif) 
+2. Switch to the **Users** tab and locate the user you wish to promote.
 
 ---
 
-2. Click the **Edit** icon located to the right of the user's name.
-
-![Snapshot](promote-02.gif) 
+3. Click the **Edit** icon located to the right of the user's name.
 
 ---
 
-3. After that, click the **Make Admin** button.
-
-![Snapshot](promote-03.gif) 
+4. After that, click the **Make Admin** button.
 
-The user's status will update immediately.
+	The user's status will update immediately.
 
 ## Revoking admin priveleges
 
 1. To revoke admin access, navigate to the **Organization Settings** page.
 
-Then, switch to the **Users** tab and locate the user whose admin priveleges you want to revoke.
-
-![Snapshot](promote-01.gif) 
+	Then, switch to the **Users** tab and locate the user whose admin priveleges you want to revoke.
 
 ---
 
 2. Click the **Edit** icon located to the right of the user's name.
 
-![Snapshot](promote-02.gif) 
-
 ---
 
 3. Then, click the **Revoke Admin Access** button.
 
-![Snapshot](revoke-03.gif) 
-
-The user's status will update immediately.
+	The user's status will update immediately.
diff --git a/docs/account-team/organizations/manage-users/index.md b/docs/account-team/organizations/manage-users/index.md
@@ -1,5 +1,5 @@
 ---
-id: manage-users
+id: org-manage-users
 title: Managing Users
 description: How to invite users to your organization in Ondsel Lens
 tags:
@@ -10,30 +10,20 @@ sidebar_position: 4
 
 ## Inviting users to organizations
 
-1. To start inviting users to an organization, click on the three dots icon at the bottom of the sidebar where your account name is.
-
-Then click on **Account Settings**.
-
-![Snapshot](add-01.gif)
+1. To start inviting users to an organization, click on the three dots icon at the bottom of the sidebar where your account name is. Then click on **Account Settings**.
 
 ---
 
 2. On the **Account Settings** page, switch to the **Users** tab.
 
-![Snapshot](add-02.gif)
-
 ---
 
 4. Click the **Invite New User** button.
 
-![Snapshot](add-03.gif)
-
 ---
 
 5. Submit user's email and click **Send**.
 
-![Snapshot](add-04.gif)
-
 ---
 
 Once the users accepts the invitation, they will show up in the list of users and will automatically be added to all existing groups in the organization with minimum priveleges.
@@ -44,44 +34,30 @@ Once the users accepts the invitation, they will show up in the list of users an
 
 1. To start removing users from an organization, first, navigate to the **Group** tab.
 
-![Snapshot](remove-01.gif) 
-
 ---
 
 2. Next, remove the user from every group they are associated with. To accomplish this, go to a specific group and click on **Add / Remove User**.
 
-![Snapshot](remove-02.gif) 
-
 ---
 
 3. Locate the user's name and uncheck the box to the left of it.
 
-![Snapshot](remove-03.gif) 
-
 ---
 
-4. Then, click on **Update**. The user will no longer be part of that group. 
-
-Repeat this process for every other group the user is a member of.
+4. Then, click on **Update**. The user will no longer be part of that group.
 
-![Snapshot](remove-04.gif) 
+	Repeat this process for every other group the user is a member of.
 
 ---
 
 5. Now that the user is no longer a member of any organization groups, go to the **Users** tab and find the user.
 
-![Snapshot](remove-05.gif) 
-
 ---
 
 6. Click on the **Edit** icon, followed by the **Remove from Organization** button.
 
-![Snapshot](remove-06.gif) 
-
 ---
 
 7. Finally, confirm your decision to complete the removal process.
 
-The user will be immediately removed from the organization.
-
-![Snapshot](remove-07.gif)
+	The user will be immediately removed from the organization.
diff --git a/docs/account-team/workspaces/create-new/index.md b/docs/account-team/workspaces/create-new/index.md
@@ -1,33 +1,25 @@
 ---
 title: Creating a New Workspace
+id: workspaces-create-new
 description: How to create a new workspace on Ondsel Lens
 sidebar_position: 2
 ---
 
-1. To create a new workspace, make sure that you are in the right organization and then click **Workspaces** in the sidebar.
-
-![Snapshot](create-ws-01.gif) 
+1. To create a new workspace, make sure that you are in the right organization and then click **Workspaces** in the left sidebar.
 
 ---
 
 2. Click on the **Create Workspace** button.
 
-![Snapshot](create-ws-02.gif) 
-
 ---
 
 3. Fill in the name of the workspace, the user-visible description, and the slug.
 
-![Snapshot](create-ws-03.jpg) 
-
 ---
 
 4. Click **Create** to finalize the creation of the new workspace.
 
-![Snapshot](create-ws-04.gif) 
-
 ---
 
 5. Once the new workspace has been created, you can click the gear icon on its card to configure the workspace's settings.
 
-![Snapshot](create-ws-05.gif) 
diff --git a/docs/account-team/workspaces/delete/index.md b/docs/account-team/workspaces/delete/index.md
@@ -1,5 +1,6 @@
 ---
 title: Deleting Workspaces
+id: workspaces-delete
 description: How to delete a workspaces on Ondsel Lens
 sidebar_position: 5
 ---

diff --git a/docs/account-team/workspaces/index.md b/docs/account-team/workspaces/index.md
@@ -1,9 +1,16 @@
 ---
 title: Workspaces
+id: workspaces
 description: How to use workspaces in Ondsel Lens
 tags:
   - workspaces
 sidebar_position: 4
 ---
 
-This section explains how to create, manage, and delete workspaces in an organization.
+This section explains how to create, manage, and delete workspaces in an organization.
+
+- [Types of Workspaces](workspaces-types)
+- [How to create a new workspace](workspaces-create-new)
+- [How to configure a workspace](workspaces-settings)
+- [How to manage a workspaces: files and directories](workspaces-files-and-directories)
+- [How to delete a workspaces](workspaces-delete)
diff --git a/docs/account-team/workspaces/manage/index.md b/docs/account-team/workspaces/manage/index.md
@@ -1,5 +1,6 @@
 ---
 title: Files and Directories
+id: workspaces-files-and-directories
 description: How to manage workspaces on Ondsel Lens
 sidebar_position: 4
 ---

diff --git a/docs/account-team/workspaces/settings/index.md b/docs/account-team/workspaces/settings/index.md
@@ -1,5 +1,6 @@
 ---
 title: Workspace Settings
+id: workspaces-settings
 description: How to manage workspaces on Ondsel Lens
 sidebar_position: 3
 ---

diff --git a/docs/account-team/workspaces/types/index.md b/docs/account-team/workspaces/types/index.md
@@ -1,5 +1,6 @@
 ---
 title: Types of Workspaces
+id: workspaces-types
 description: What workspace types are available in Ondsel Lens
 sidebar_position: 1
 ---

diff --git a/docs/index.md b/docs/index.md
@@ -1,5 +1,5 @@
 ---
-title: Overview 
+title: Welcome 
 description: What is Ondsel Lens?
 sidebar_position: 1
 ---
@@ -8,7 +8,7 @@ Ondsel Lens is an online vaulting and product data management service for mechan
 
 <img src="/img/ondsel-lens-public-1.png" alt="Ondsel Lens" width="66%" />
 
-With Ondsel Lens you can:
+## Features
 
 * Organize a team working on a product: create multiple workspaces per organization, invite and assign members
 * Manage the privacy of your designs
@@ -20,6 +20,14 @@ With Ondsel Lens you can:
 * Control whether people accessing your share link can download the design
 * Create and organize bookmarks for other people’s work
 
-Additionally, Lens supports uploading and downloading OBJ and STL files.
+## Let's get started
+
+- [Upload a file](/docs/upload-share/upload/)
+- [Explore it on Lens](/docs/explore/)
+- [Create a PIN-protected share link](/docs/upload-share/pin-protected-share-links/)
+- [Create a new workspace in your organization](/docs/account-team/workspaces/create-new/)
+- [Invite team members](/docs/account-team/organizations/manage-users/)
+
+## Project Background
 
 Lens is	built around [FreeCAD](https://www.freecad.org/), a free and open-source 3D CAD suite. It runs a containerized version of FreeCAD and uses some of the advanced features of the program.