feat(dev-portal): Portal Editor updates and consolidate Portal customization pages (#3294)

* Draft new Portal Editor changes

Signed-off-by: Diana <[email protected]>

* Consolidate customization pages, add redirects

Signed-off-by: Diana <[email protected]>

* Fix screenshots

Signed-off-by: Diana <[email protected]>

---------

Signed-off-by: Diana <[email protected]>
Co-authored-by: Jason Harmon <[email protected]>

Author: cloudjumpercat

app/_indices/dev-portal.yaml

@@ -32,8 +32,6 @@ sections:
       - path: /dev-portal/customizations/dev-portal-customizations/
       - path: /dev-portal/pages-and-content/
       - path: /dev-portal/custom-domains/
-      - path: /dev-portal/customization-settings/
-      - path: /dev-portal/portal-customization/
   - title: Access and approvals
     items:
       - path: /dev-portal/team-mapping/

app/_landing_pages/dev-portal.yaml

@@ -121,8 +121,6 @@ rows:
                 url: "/dev-portal/pages-and-content/"
               - text: Custom domains
                 url: "/dev-portal/custom-domains/"
-              - text: Customization settings
-                url: "/dev-portal/portal-customization/"
               - text: Dev Portal settings
                 url: "/dev-portal/portal-settings/"
       - blocks:

app/_landing_pages/dev-portal/customizations/dev-portal-customizations.yaml

@@ -139,6 +139,7 @@
 /dev-portal/application-registration/   /dev-portal/self-service/
 /dev-portal/access-and-approval/    /dev-portal/self-service/
 /dev-portal/publishing/ /catalog/apis/
+/dev-portal/portal-customization/   /dev-portal/customizations/dev-portal-customizations/
 
 
 # Gateway LTS

app/_redirects

@@ -339,7 +339,7 @@ Publishing an API makes it available to one or more [Dev Portals](/dev-portal/).
    Publishing an API requires you to have the [`Product Publisher` {{site.konnect_short_name}} role](/konnect-platform/teams-and-roles/#dev-portal).
 
 {:.info}
-> * The visibility of [pages](/dev-portal/pages-and-content/) and [menus](/dev-portal/portal-customization/) is configured independently from APIs, maximizing your flexibility.
+> * The visibility of [pages](/dev-portal/pages-and-content/) and [menus](/dev-portal/customizations/dev-portal-customizations/) is configured independently from APIs, maximizing your flexibility.
 > * {% new_in 3.6 %} An API must be linked to a {{site.konnect_short_name}} Gateway Service to be able to restrict access to your API with authentication strategies.
 
 With the appropriate [security](/dev-portal/security-settings/) and [access and approval](/dev-portal/self-service/) settings, you can publish an API securely to the appropriate audience. The following table describes various Dev Portal access control scenarios and their settings:

app/assets/images/dev-portal/dev-portal-appearance.png

@@ -18,8 +18,6 @@ works_on:
 description: "Use a custom URL for Dev Portal."
 
 related_resources:
-  - text: Portal customization reference
-    url: /dev-portal/portal-customization/
   - text: Pages and content
     url: /dev-portal/pages-and-content/
   - text: Dev Portal settings

app/assets/images/dev-portal/dev-portal-editor.png

@@ -80,8 +80,6 @@ faqs:
 related_resources:
   - text: Dev Portal Markdown components reference
     url: https://portaldocs.konghq.com/
-  - text: Portal customization reference
-    url: /dev-portal/portal-customization/
   - text: Custom domains
     url: /dev-portal/custom-domains/
   - text: About Dev Portal customizations
@@ -97,6 +95,8 @@ In your Dev Portal, you can create pages that contain content such as text, butt
 
 You can create multiple pages in the Dev Portal, similar to how a website is structured. Pages can contain text and other objects, like containers and buttons. To get started creating pages, navigate to your Dev Portal and click **Portal Editor** in the sidebar. Pages are built using Markdown Components (MDC). Additional documentation on syntax, as well as tools for generating components, are available on a [dedicated MDC site](https://portaldocs.konghq.com/).
 
+Custom pages allow you to define a page structure/tree that organizes your pages and generates the page URL based on page slugs. The generated URL is shown at the bottom of the preview pane.
+
 ### Page structure
 
 On the left panel inside the Portal Editor, you'll see a list of pages in your Dev Portal. The name for each page is a `slug`, and will be used to build the URL for that page. You can nest child pages under other pages. If pages are nested, the slugs will be combined to build the URL.