inprogress - set up defectdojo structure

Author: paulOsinski

docs/config/_default/menus/menus.en.toml

@@ -10,33 +10,38 @@
 
 [[main]]
   name = "Triage Findings ⏷"
-  url = "/triage_findings/"
+  url = "/triage_findings/findings/intro_to_findings/"
   weight = 12
 
 [[main]]
-  name = "Metrics & reports ⏷"
-  url = "/metrics_reports/"
+  name = "Model your assets ⏷"
+  url = "/asset_modelling/hierarchy/pro__assets_organizations/"
   weight = 13
 
 [[main]]
-  name = "Admin ⏷"
-  url = "/admin/"
+  name = "Metrics & reports ⏷"
+  url = "/metrics_reports/dashboards/introduction_dashboard/"
   weight = 14
 
+[[main]]
+  name = "Admin ⏷"
+  url = "/admin/admin_intro/intro/"
+  weight = 16
+
 [[main]]
   name = "Issue tracking ⏷"
-  url = "/issue_tracking/"
-  weight = 14
+  url = "/issue_tracking/intro/intro/"
+  weight = 15
 
 [[main]]
   name = "Automation ⏷"
-  url = "/automation/"
-  weight = 14
+  url = "/automation/api/api-v2-docs/"
+  weight = 15
 
 [[main]]
   name = "Supported tools ⏷"
   url = "/supported_tools/"
-  weight = 15
+  weight = 16
 
 [[social]]
   name = "YouTube"

docs/config/_default/params.toml

@@ -54,6 +54,7 @@ mainSections = ["docs"]
     "metrics_reports",
     "admin",
     "automation",
+    "asset_modelling",
     "issue_tracking"] # ["docs"] (default) or list of sections (e.g. ["docs", "guides"])
 
   toTopButton = false # false (default) or true

docs/content/admin/admin_intro/_index.md

@@ -0,0 +1,16 @@
+---
+title: "Intro"
+description: ""
+summary: ""
+date: 2023-09-07T16:06:50+02:00
+lastmod: 2023-09-07T16:06:50+02:00
+draft: false
+weight: 3
+chapter: true
+seo:
+  title: "" # custom title (optional)
+  description: "" # custom description (recommended)
+  canonical: "" # custom canonical URL (optional)
+  robots: "" # custom robot tags (optional)
+exclude_search: true
+---

docs/content/admin/admin_intro/intro.md

@@ -0,0 +1,9 @@
+---
+title: "DefectDojo Admin Controls"
+description: "Administrative controls for configuring, securing, and maintaining your DefectDojo instance."
+weight: 0
+---
+
+Admin actions in DefectDojo provide the controls needed to configure and maintain the platform across your organization. These actions are designed for administrators who are responsible for user management, system configuration, and ensuring DefectDojo operates securely and reliably at scale.
+
+Administrative actions allow you to manage core aspects of DefectDojo, including authentication methods, user access, global settings, and integrations. From initial setup to ongoing maintenance, these controls define how DefectDojo behaves and how users interact with it.

docs/content/admin/notifications/_index.md

@@ -6,8 +6,6 @@ lastmod: 2023-09-07T16:06:50+02:00
 draft: false
 weight: 7
 chapter: true
-sidebar:
-  collapsed: true
 seo:
   title: "" # custom title (optional)
   description: "" # custom description (recommended)

docs/content/admin/user_management/_index.md

@@ -7,8 +7,6 @@ lastmod: 2023-09-07T16:06:50+02:00
 draft: false
 weight: 5
 chapter: true
-sidebar:
-  collapsed: true
 seo:
   title: "" # custom title (optional)
   description: "" # custom description (recommended)

docs/content/admin/user_management/pro_permissions_overhaul.md

@@ -1,9 +1,34 @@
 ---
-title: "🟧 Set Permissions in Pro"
+title: "Set Permissions in Pro"
 description: "Overhaul, pro feature"
 weight: 3
+audience: pro
 ---
 
+## Introduction to Permission Types
+
+Individual users have four different kinds of permission that they can be assigned:
+
+* Users can be assigned as **Members to Products or Product Types**. This allows them to view and interact with Data Types (Product Types, Products, Engagements, Tests and Findings) in DefectDojo depending on the role they are assigned on the specific Product. Users can have multiple Product or Product Type memberships, with different levels of access.  
+​
+* Users can also have **Configuration Permissions** assigned, which allow them to access configuration pages in DefectDojo. Configuration Permissions are not related to Products or Product Types.  
+​
+* Users can be assigned **Global Roles**, which give them a standardized level of access to all Products and Product Types.  
+​
+* Users can be set up as **Superusers**: administrator level roles which give them control and access to all DefectDojo data and configuration.
+
+You can also create Groups if you want to assign Product Membership, Configuration Permissions or Global Roles to a group of users at the same time. If you have a large number of users in DefectDojo, such as a dedicated testing team for a particular Product, Groups may be a more helpful feature. 
+
+## Superusers \& Global Roles
+
+Part of your Role\-Based Access Control (RBAC) configuration may require you to create additional Superusers, or users with Global Roles.
+
+* Superusers (Admins) have no limitations in the system. They can change all settings, manage users and have read / write access to all data. They can also change access rules for all users in DefectDojo. Superusers will also receive notifications for all system issues and alerts.
+* Users with Global Roles can view and interact with any Data Type (Product Types, Products, Engagements, Tests and Findings) in DefectDojo depending on their assigned Role. For more information about each Role and associated privileges, please refer to our Introduction to Roles article.
+* Users can also have specific Configuration Permissions assigned, allowing them to access certain DefectDojo configuration pages. Users have no Configuration Permissions by default.
+
+By default, the first account created on a new DefectDojo instance will have Superuser permissions. That user will be able to edit permissions for all subsequent DefectDojo users. Only an existing Superuser can add another superuser, or add a Global Role to a user.
+
 Permissions in <span style="background-color:rgba(242, 86, 29, 0.3)">DefectDojo Pro</span> have been simplified, to make it easier to assign object access.  This feature can be accessed through the [Pro UI](/en/about_defectdojo/ui_pro_vs_os/).
 
 ### Opening the Permissions window 

docs/content/admin/user_management/set_user_permissions.md

@@ -2,6 +2,7 @@
 title: "Set a User's permissions"
 description: "How to grant Roles & Permissions to a user, as well as superuser status"
 weight: 2
+audience: opensource
 ---
 
 ## Introduction to Permission Types
@@ -42,7 +43,7 @@ By default, the first account created on a new DefectDojo instance will have Sup
 
 4. From the Edit User page:   
 ​  
-For Superuser Status, check off the ☑️Superuser Status box, located in the user's Default Information.  
+For Superuser Status, check off the ☑️ Superuser Status box, located in the user's Default Information.  
 ​  
 To assign a Global Role, select one from the dropdown Global Role menu at the bottom of the page.  
 ​

…findings/working_with_findings/_index.md docs/content/asset_modelling/_index.mddocs/content/triage_findings/working_with_findings/_index.md renamed to docs/content/asset_modelling/_index.md docs/content/triage_findings/working_with_findings/_index.md renamed to docs/content/asset_modelling/_index.md

@@ -1,5 +1,5 @@
 ---
-title: "🚩 Work With Findings"
+title: "Organize DefectDojo"
 date: 2021-02-02T20:46:29+01:00
 draft: false
 type: docs

docs/content/asset_modelling/engagements_tests/_index.md

@@ -0,0 +1,8 @@
+---
+title: "Engagements & Tests"
+date: 2021-02-02T20:46:29+01:00
+draft: false
+type: docs
+weight: 1
+exclude_search: true
+---