Merge branch 'contribution-guide' of https://github.com/TykTechnologies/tyk-docs into contribution-guide

Author: sharadregoti

.github/pull_request_template.md

@@ -1,13 +1,14 @@
-## Preview Link
+## Contributor checklist
 
-## Checklist
+- [ ] Reviewed *PR Code suggestions* and updated accordingly
+- [ ] **Tyklings:** Labled the PR with the relevant releases
+- [ ] **Tyklings:** Added Jira DX PR ticket to the subject
 
-- [ ] Added a **preview link**
-- [ ] Reviewed AI PR Agent suggestions
-- [ ] **For Tyk Members** - Added Jira DX PR ticket to the subject
-- [ ] **For Tyk Members** - Added the appropriate release labels (for fixes add the latest release)
+---
 
 ## New Contributors 
-- [ ] Make sure you have started *your change* off *our latest `master`*.
-- [ ] I have [reviewed the guidelines](https://github.com/TykTechnologies/tyk-docs/blob/master/CONTRIBUTING.md) for contributing to this repository.
-- [ ] I have [read the technical guidelines](https://github.com/TykTechnologies/tyk-docs/blob/master/CONTRIBUTING-TECHNICAL-GUIDE.md) for contributing to this repository.
+- [ ] Start the PR branch from our latest `master`
+- [ ] I have read the [repository contribution guidelines](https://github.com/TykTechnologies/tyk-docs/blob/master/CONTRIBUTING.md)
+- [ ] I have read the [repository technical guidelines](https://github.com/TykTechnologies/tyk-docs/blob/master/CONTRIBUTING-TECHNICAL-GUIDE.md)
+
+---

.github/workflows/page_available_since.yml

@@ -3,7 +3,7 @@ on:
   workflow_dispatch:
 jobs:
   check-page-availability:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-latest
     name: Check version a page is available
     steps:
 

.probe/writer.md

@@ -1,3 +1,16 @@
-You are senior technical writer.
-Before jumping on the task you first, in details analyse user request, and try to provide elegant and concise solution.
-If solution is clear, you can jump to implementation right away, if not, you can ask user a clarification question, by calling attempt_completion tool, with required details.
+You are helpful senior technical writer.
+Your role is to automatically assist with GitHub issues.
+
+Before jumping on the task or replying, you first should analyze the user request or issue details thoroughly.
+
+When responding:
+1. Be concise but thorough in your responses.
+2. If the issue description is unclear, ask clarifying questions.
+3. Request any additional information you might need to better assist
+4. Provide helpful information related to the query
+5. Try to provide an elegant and concise solution.
+6. If there are multiple different solutions or next steps, convey it in the response
+7. If solution is clear, you can jump to implementation right away, if not, you can ask user a clarification question, by calling attempt_completion tool, with required details.
+
+When writing content:
+Don’t use title case. Following sentence case conventions, like in Google and GitHub style guides.

tyk-docs/assets/others/enterprise-developer-portal-swagger.yaml

@@ -1,7 +1,10 @@
 openapi: 3.1.0
 info:
-  title: Tyk Enterprise Developer Portal Management API
+  title: Tyk Developer Portal
   description: >-
+    
+    <img src="https://tyk.io/docs/img/developer_portal_swagger_image.png" width="963" height="250">
+    
     ## <a name="introduction"></a> Introduction
 
     The Tyk Enterprise Developer Portal Management API offers programmatic
@@ -15,7 +18,7 @@ info:
 
     This API requires an admin authorisation token that is available for admin
     users of the portal in the profile page.
-  version: v1.13.0
+  version: 1.14.0
 servers:
   - url: http://localhost:3001/portal-api
 tags:
@@ -63,6 +66,8 @@ tags:
     description: Posts management
   - name: SSO Profiles
     description: SSO Profiles management
+  - name: Tags
+    description: "Tags management: link API Products to blog posts and control their display."
 paths:
   /access_requests:
     get:
@@ -4177,6 +4182,7 @@ paths:
   /webhooks:
     get:
       summary: List all webhooks
+      description: Retrieves all configured webhooks.
       operationId: list-webhooks
       tags:
         - Webhooks
@@ -4189,6 +4195,7 @@ paths:
                 $ref: "#/components/schemas/Webhook-index"
     post:
       summary: Create a new webhook
+      description: Creates a new webhook configuration.
       operationId: create-webhook
       tags:
         - Webhooks
@@ -4215,6 +4222,7 @@ paths:
   /webhooks/{webhook_id}:
     get:
       summary: Get a webhook by ID
+      description: Retrieves a webhook using its unique identifier.
       operationId: get-webhook
       tags:
         - Webhooks
@@ -4239,6 +4247,7 @@ paths:
           description: Bad request
     put:
       summary: Update a webhook by ID
+      description: Updates an existing webhook's configuration using its unique identifier.
       operationId: update-webhook
       tags:
         - Webhooks
@@ -4270,6 +4279,7 @@ paths:
           description: Bad request
     delete:
       summary: Delete a webhook by ID
+      description: Removes a webhook using its unique identifier.
       operationId: delete-webhook
       tags:
         - Webhooks
@@ -4295,6 +4305,7 @@ paths:
   /webhooks/{webhook_id}/headers:
     get:
       summary: List all headers for a webhook
+      description: Retrieves all headers for a specific webhook.
       operationId: list-webhook-headers
       tags:
         - Webhooks
@@ -4319,6 +4330,7 @@ paths:
           description: Bad request
     post:
       summary: Add a new header to a webhook
+      description: Adds a new header to an existing webhook.
       operationId: create-webhook-header
       tags:
         - Webhooks
@@ -4351,6 +4363,9 @@ paths:
   /webhooks/{webhook_id}/headers/{header_id}:
     get:
       summary: Get a header by ID for a specific webhook
+      description: >-
+        Retrieves the details of a specific header associated with a given webhook. 
+        Useful for inspecting custom headers configured for webhook delivery.
       operationId: get-webhook-header
       tags:
         - Webhooks
@@ -4380,6 +4395,7 @@ paths:
           description: Bad request
     put:
       summary: Update a header by ID for a specific webhook
+      description: Updates an existing header in a webhook.
       operationId: update-webhook-header
       tags:
         - Webhooks
@@ -4422,6 +4438,7 @@ paths:
           description: Validation error
     delete:
       summary: Delete a header by ID for a specific webhook
+      description: Removes a header from a webhook.
       operationId: delete-webhook-header
       tags:
         - Webhooks
@@ -5870,6 +5887,18 @@ components:
           type: integer
           description: UID of a user to whom this application will belong
           example: 1
+        Visibility:
+          type: string
+          description: >-
+            Controls who can access this application. Options are:
+            `personal` (visible only to you), `team` (shared with your team),
+            and `organisation` (accessible to all members of your organisation).
+          enum:
+            - personal
+            - team
+            - organisation
+          example: personal
+          default: organisation
       type: object
     Client-ID-attributes:
       properties:

tyk-docs/content/ai-management/mcps/api-to-mcp.md

@@ -25,13 +25,13 @@ graph LR
     D["AI Assistant"] <--> C
     C <--> E["Your API"]
     
-    style A fill:#d3e5ef,stroke:#333,stroke-width:2px,font-size:18px
-    style B fill:#d5f5e3,stroke:#333,stroke-width:2px,font-size:18px
-    style C fill:#d5f5e3,stroke:#333,stroke-width:2px,font-size:18px
-    style D fill:#eeeeee,stroke:#333,stroke-width:2px,font-size:18px
-    style E fill:#fdebd0,stroke:#333,stroke-width:2px,font-size:18px
+    style A fill:#ffffff,stroke:#D1D1E0,stroke-width:1px,font-size:18px
+    style B fill:#d5f5e3,stroke:#D1D1E0,stroke-width:1px,font-size:18px
+    style C fill:#d5f5e3,stroke:#D1D1E0,stroke-width:1px,font-size:18px
+    style D fill:#eeeeee,stroke:#D1D1E0,stroke-width:1px,font-size:18px
+    style E fill:#ffffff,stroke:#D1D1E0,stroke-width:1px,font-size:18px
     
-    linkStyle default stroke-width:3px
+    linkStyle default stroke-width:2px
 ```
 
 ## Key Features
@@ -44,7 +44,7 @@ graph LR
 - **MCP Extensions:** Support for custom x-mcp extensions to override tool names and descriptions
 - **Multiple Integration Options:** Works with Claude Desktop, Cursor, Vercel AI SDK, and other MCP-compatible environments
 
-Check the [complete technical list](https://github.com/TykTechnologies/api-to-mcp#features) is available in our GitHub repository.
+Check the [complete features list](https://github.com/TykTechnologies/api-to-mcp#features) is available in Tyk's *api-to-mcp* GitHub repository.
 
 ## Quick Start {#quick-start}
 
@@ -134,9 +134,11 @@ flowchart LR
     class A,B input;
     class C,D,E,F tool;
     class G,H,I runtime;
+
+linkStyle default stroke-width:2px
 ```
 
-### Request lifecycle: how an AI assistant invokes an API tool”
+### Request lifecycle: how an AI assistant invokes an API tool
 
 The following diagram illustrates the flow of a request through the system at runtime:
 
@@ -167,6 +169,7 @@ sequenceDiagram
         Tool->>MCP: Map to MCP Error
         MCP-->>AI: Tool Execution Error
     end
+
 ```
 
 API to MCP  can be found in [api-to-mcp GitHub repository](https://github.com/TykTechnologies/api-to-mcp)

tyk-docs/content/configure/outbound-email-configuration.md

@@ -12,24 +12,7 @@ algolia:
   importance: 0
 ---
 
-{{< warning success >}}
-
-**Attention:**
-
-You’ve reached a page related to the *Tyk Classic Portal*. If you were searching for *API documentation of the new Tyk
-Developer Portal* please use the latest
-[Postman collection]({{< ref "/product-stack/tyk-enterprise-developer-portal/api-documentation/tyk-edp-api" >}}) page.
-</br>
-</br>
-**Future deprecation of Tyk Classic Portal**
-
-This product is no longer actively developed as it
-has been superseded by the new [Tyk Developer Portal]({{< ref "portal/overview/intro" >}}).
-</br>
-Please note that the Tyk Classic Portal now has limited support and maintenance. Please contact us at
-[[email protected]](<mailto:[email protected]?subject=Tyk classic developer portal>)if you have any questions.
-
-{{< /warning >}}
+{{< include "legacy-classic-portal-api" >}}
 
 ### Custom Email Templates
 

tyk-docs/content/developer-support/release-notes/dashboard.md

@@ -38,6 +38,66 @@ Our minor releases are supported until our next minor comes out.
 
 ## 5.8 Release Notes
 
+### 5.8.2 Release Notes
+
+#### Release Date 1st July 2025
+
+#### Release Highlights
+
+This is a version bump to align with Gateway v5.8.2, no changes have been implemented in this release.
+
+#### Breaking Changes
+
+There are no breaking changes in this release.
+
+#### Dependencies {#dependencies-5.8.2}
+
+##### Compatibility Matrix For Tyk Components
+
+| Dashboard Version | Recommended Releases | Backwards Compatibility |
+|----    |---- |---- |
+| 5.8.2 | MDCB v2.8.1     | MDCB v2.8.1 |
+|         | Operator v1.2.0  | Operator v0.17 |
+|         | Sync v2.1.0    | Sync v2.1.0 |
+|         | Helm Chart v3.0  | Helm all versions |
+| | EDP v1.13 | EDP all versions |
+| | Pump v1.12.0| Pump all versions |
+| | TIB (if using standalone) v1.7.0 | TIB all versions |
+
+##### 3rd Party Dependencies & Tools {#3rdPartyTools-v5.8.2}
+
+| Third Party Dependency                                     | Tested Versions        | Compatible Versions    | Comments | 
+| ---------------------------------------------------------- | ---------------------- | ---------------------- | -------- | 
+| [GoLang](https://go.dev/dl/)                               | 1.23       | 1.23       | [Go plugins]({{< ref "api-management/plugins/golang" >}}) must be built using Go 1.23 | 
+| [Redis](https://redis.io/download/)  | 6.2.x, 7.x  | 6.2.x, 7.x  | Used by Tyk Dashboard | 
+| [MongoDB](https://www.mongodb.com/try/download/community)  | 5.0.x, 6.0.x, 7.0.x  | 5.0.x, 6.0.x, 7.0.x  | Used by Tyk Dashboard | 
+| [PostgreSQL](https://www.postgresql.org/download/)         | 13.x - 17.x        | 13.x - 17.x            | Used by Tyk Dashboard | 
+| [OpenAPI Specification](https://spec.openapis.org/oas/v3.0.3) | v3.0.x      | v3.0.x          | Supported by [Tyk OAS]({{< ref "api-management/gateway-config-tyk-oas#tyk-vendor-extension-reference" >}})|
+
+#### Deprecations
+
+There are no deprecations in this release.
+
+#### Upgrade instructions {#upgrade-5.8.2}
+
+If you are upgrading to 5.8.2, please follow the detailed [upgrade instructions](#upgrading-tyk). 
+
+#### Downloads
+
+- [Docker Image to pull](https://hub.docker.com/r/tykio/tyk-dashboard/tags?page=&page_size=&ordering=&name=v5.8.2)
+  - ```bash
+    docker pull tykio/tyk-dashboard:v5.8.2
+    ```
+- Helm charts
+  - [tyk-charts v3.0.0]({{< ref "developer-support/release-notes/helm-chart#300-release-notes" >}})
+
+#### Changelog {#Changelog-v5.8.2}
+
+No changes in this release.
+
+
+---
+
 ### 5.8.1 Release Notes
 
 #### Release Date 9 May 2025