Update docs

Author: handotdev

advanced/custom/js.mdx

@@ -1,7 +1,6 @@
 ---
 title: 'Editor Permissions'
 description: 'Allow more members of your team to update your docs'
-icon: 'user-group-simple'
 ---
 
 The team member who created your initial docs will have update access to your docs, as long as they push to your documentation repo with the same GitHub account that was used while signing up for Mintlify.

settings/add-members.mdx renamed to advanced/dashboard/permissions.mdx

@@ -1,10 +1,9 @@
 ---
 title: "Single Sign-On (SSO)"
-description: "Customize how your team can login to your Mintlify dashboard"
-icon: 'user-unlock'
+description: "Customize how your team can login to your admin dashboard"
 ---
 
-Mintlify supports single sign-on to your dashboard via SAML and OIDC. If you use Okta or Google Workspace, we have provider-specific documentation for setting up SSO, but if you use another provider, please contact us!
+Use single sign-on to your dashboard via SAML and OIDC. If you use Okta or Google Workspace, we have provider-specific documentation for setting up SSO, but if you use another provider, please contact us!
 
 <Note>
   SSO functionality is available on our Enterprise plan. [Contact

settings/authentication.mdx renamed to advanced/dashboard/sso.mdx

@@ -1,5 +1,5 @@
 ---
-title: 'Interactive Playground'
+title: 'Playground'
 description: 'Enable users to interact with your API'
 openapi: 'GET /plants/{id}'
 hideApiMarker: true

api-playground/overview.mdx

@@ -79,9 +79,8 @@
             "pages": [
               "settings/custom-domain",
               "settings/seo",
+              "settings/custom-scripts",
               "settings/broken-links",
-              "settings/add-members",
-              "settings/authentication",
               "settings/github",
               "settings/gitlab",
               "settings/ci",
@@ -91,11 +90,6 @@
           {
             "group": "Advanced",
             "pages": [
-              {
-                "group": "Custom Scripts",
-                "icon": "code",
-                "pages": ["advanced/custom/css", "advanced/custom/js"]
-              },
               {
                 "group": "Custom Subdirectory",
                 "icon": "folder",
@@ -135,6 +129,11 @@
                   "settings/authentication-personalization/sending-data"
                 ]
               },
+              {
+                "group": "Dashboard Access",
+                "icon": "house-lock",
+                "pages": ["advanced/dashboard/sso", "advanced/dashboard/permissions"]
+              },
               {
                 "group": "REST API",
                 "icon": "brackets-curly",
@@ -257,9 +256,6 @@
       }
     ]
   },
-  "styling": {
-    "codeblocks": "system"
-  },
   "logo": {
     "light": "/logo/light.svg",
     "dark": "/logo/dark.svg",

docs.json

@@ -1,14 +1,14 @@
 ---
 title: CI Checks
-description: "Use Mintlify's CI tools to lint your docs"
+description: "Add broken links, linting, and grammar checks to the updating process"
 icon: 'circle-check'
 ---
 
 <Warning>
-  This feature is only available for customers on paid plans using GitHub. If you'd like it enabled for other platforms, please provide [feedback](https://feedback.mintlify.com/roadmap).
+  This feature is only available for customers on paid plans and for GitHub. Support for other platforms is coming soon.
 </Warning>
 
-Mintlify is capable of using its installed Github App to lint your docs for errors, and give you warnings before you deploy.
+Use CI checks to lint your docs for errors, and give you warnings before you deploy.
 
 ## Installation
 

settings/ci.mdx

@@ -1,15 +1,16 @@
 ---
-title: 'Custom CSS'
-description: 'Fully customize your documentation with custom CSS'
+title: 'Custom CSS & JS'
+description: 'Fully customize your documentation with custom CSS & JS'
+icon: 'code'
 ---
 
-<Check>
-  Custom CSS is available as an add-on to the [Pro plan](https://mintlify.com/pricing).
-</Check>
+Add custom CSS & JS to your documentation to fully customize the look and feel.
+
+## Custom CSS
 
 Add any number of CSS files to your repository and the defined class names will be applied and available across all of your MDX files.
 
-## Adding style.css
+### Adding style.css
 
 For example, you can add the following `style.css` file to customize the styling of the navbar and footer.
 
@@ -24,7 +25,7 @@ footer {
 }
 ```
 
-## Using Identifiers
+### Using Identifiers
 
 Mintlify has a set of common identifiers to help you tag important elements of the UI. Some, but not all are listed in the following:
 
@@ -39,3 +40,25 @@ Mintlify has a set of common identifiers to help you tag important elements of t
   References and the styling of common elements are subject to change as the
   platform evolves. Please use custom styling with caution.
 </Warning>
+
+## Custom JS
+
+Custom JS allows you to add custom executable code globally. It is the equivalent of adding a `<script>` tag with JS code into every page.
+
+### Adding Custom JavaScript
+
+Any `.js` file inside the content directory of your docs will be included in every documentation page. For example, you can add the following `ga.js` file to enable [Google Analytics](https://marketingplatform.google.com/about/analytics) across the entire documentation.
+
+```js
+window.dataLayer = window.dataLayer || [];
+function gtag() {
+  dataLayer.push(arguments);
+}
+gtag('js', new Date());
+
+gtag('config', 'TAG_ID');
+```
+
+<Warning>
+  Please use with caution to not introduce security vulnerabilities.
+</Warning>