Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DX-1802] Dashboard Release Note 5.8.0 #5901

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from
Draft

Conversation

Eopayemi
Copy link
Contributor

@Eopayemi Eopayemi commented Jan 20, 2025

User description

For internal users - Please add a Jira DX PR ticket to the subject!

DX-1802


Preview Link

Preview

Description

Release note for dashboard

Screenshots (if appropriate)


Checklist

  • I have added a preview link to the PR description.
  • I have reviewed the suggestions made by our AI (PR Agent) and updated them accordingly (spelling errors, rephrasing, etc.)
  • I have reviewed the guidelines for contributing to this repository.
  • I have read the technical guidelines for contributing to this repository.
  • Make sure you have started your change off our latest master.
  • I labeled the PR

PR Type

Documentation


Description

  • Added release notes for Tyk Dashboard version 5.8.0.

  • Included compatibility matrix for Tyk components and third-party tools.

  • Provided upgrade instructions and download links for version 5.8.0.

  • Added placeholders for changelog items under "Added" and "Fixed" sections.


Changes walkthrough 📝

Relevant files
Documentation
dashboard.md
Added release notes for Tyk Dashboard 5.8.0                           

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

  • Added detailed release notes for version 5.8.0.
  • Included compatibility matrix for Tyk components and third-party
    tools.
  • Added upgrade instructions and download links for version 5.8.0.
  • Added placeholders for changelog items under "Added" and "Fixed"
    sections.
  • +100/-0 

    💡 PR-Agent usage: Comment /help "your question" on any pull request to receive relevant information

    Copy link
    Contributor

    PR Reviewer Guide 🔍

    Here are some key observations to aid the review process:

    ⏱️ Estimated effort to review: 2 🔵🔵⚪⚪⚪
    🧪 No relevant tests
    🔒 No security concerns identified
    ⚡ Recommended focus areas for review

    Missing Content

    Several placeholders for summaries and descriptions (e.g., release highlights, changelog items) are left incomplete and need to be filled with actual content.

    ##### Add release highlight summary
    
    Add release highlight description
    
    #### Breaking Changes
    <!-- Required. Use the following statement if there are no breaking changes, or explain if there are -->
    
    There are no breaking changes in this release.
    
    #### Dependencies {#dependencies-5.8.0}
    
    ##### Compatibility Matrix For Tyk Components
    
    | Dashboard Version | Recommended Releases | Backwards Compatibility |
    |----    |---- |---- |
    | 5.8.0 | MDCB v2.7.2     | MDCB v2.5.1 |
    |         | Operator v1.1.0  | Operator v0.17 |
    |         | Sync v2.0.1    | Sync v1.4.3 |
    |         | Helm Chart v2.2  | Helm all versions |
    | | EDP v1.12 | EDP all versions |
    | | Pump v1.11.1 | Pump all versions |
    | | TIB (if using standalone) v1.6.1 | TIB all versions |
    
    ##### 3rd Party Dependencies & Tools {#3rdPartyTools-v5.8.0}
    
    | Third Party Dependency                                     | Tested Versions        | Compatible Versions    | Comments | 
    | ---------------------------------------------------------- | ---------------------- | ---------------------- | -------- | 
    | [GoLang](https://go.dev/dl/)                               | 1.22       | 1.22       | [Go plugins]({{< ref "plugins/supported-languages/golang" >}}) must be built using Go 1.22 | 
    | [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/)         | 12.x - 16.x LTS        | 12.x - 16.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 "tyk-apis/tyk-gateway-api/oas/x-tyk-oas-doc" >}})|
    
    #### Deprecations
    
    There are no deprecations in this release.
    
    #### Upgrade instructions {#upgrade-5.8.0}
    
    If you are upgrading to 5.8.0, 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.0)
      - ```bash
        docker pull tykio/tyk-dashboard:v5.8.0
        ```
    - Helm charts
      - [tyk-charts v2.2.0]({{< ref "developer-support/release-notes/helm-chart#220-release-notes" >}})
    
    #### Changelog {#Changelog-v5.8.0}
    
    ##### Added
    
    <ul>
    <li>
    <details>
    <summary>Add Changelog item summary</summary>
    
    Add changelog description
    </details>
    </li>
    <li>
    <details>
    <summary>Add changelog item summary</summary>
    
    Add changelog description
    </details>
    </li>
    </ul>
    
    ##### Fixed
    
    <ul>
    <li>
    <details>
    <summary>Add changelog item summary</summary>
    
    Add changelog description
    </details>
    </li>
    <li>
    <details>
    <summary>Add changelog item summary</summary>
    
    Add changelog description 
    </details>

    Copy link
    Contributor

    PR Code Suggestions ✨

    Explore these optional code suggestions:

    CategorySuggestion                                                                                                                                    Score
    General
    Replace placeholder release date

    Ensure the release date placeholder "xxx" is replaced with the actual release date
    to provide accurate information to users.

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

    -#### Release Date xxx
    +#### Release Date 2025-01-20
    Suggestion importance[1-10]: 9

    Why: Providing the actual release date is essential for accurate and reliable documentation. This change ensures users have the correct information about the release timeline.

    9
    Replace placeholder text with actual content

    Replace placeholder text such as "Add release highlight summary", "Add release
    highlight description", and "Add changelog description" with actual content to
    ensure the release notes are complete and informative for users.

    tyk-docs/content/developer-support/release-notes/dashboard.md [46-48]

    -##### Add release highlight summary
    +##### Major Performance Improvements
     
    -Add release highlight description
    +This release introduces significant enhancements in API response times and dashboard load speeds, ensuring a smoother user experience.
    Suggestion importance[1-10]: 8

    Why: Replacing placeholder text with actual content significantly improves the clarity and usefulness of the release notes, making them more informative for users. This is a critical enhancement for documentation quality.

    8
    Add meaningful changelog summaries and descriptions

    Add meaningful summaries and descriptions for the changelog items to clearly
    communicate the changes and fixes introduced in this release.

    tyk-docs/content/developer-support/release-notes/dashboard.md [100-125]

     <li>
     <details>
    -<summary>Add Changelog item summary</summary>
    +<summary>Improved API Gateway Performance</summary>
     
    -Add changelog description
    +Optimized the API Gateway to handle requests more efficiently, reducing latency by 20%.
     </details>
     </li>
    Suggestion importance[1-10]: 8

    Why: Adding meaningful summaries and descriptions to the changelog items enhances the documentation by clearly communicating the changes and fixes introduced. This improves user understanding and the overall quality of the release notes.

    8

    @Eopayemi Eopayemi marked this pull request as draft January 20, 2025 11:58
    Copy link

    netlify bot commented Jan 20, 2025

    PS. Pls add /docs/nightly to the end of url

    Name Link
    🔨 Latest commit e753a23
    🔍 Latest deploy log https://app.netlify.com/sites/tyk-docs/deploys/678e3a15e2707200083bef44
    😎 Deploy Preview https://deploy-preview-5901--tyk-docs.netlify.app
    📱 Preview on mobile
    Toggle QR Code...

    QR Code

    Use your smartphone camera to open QR code link.

    To edit notification comments on pull requests, go to your Netlify site configuration.

    1 similar comment
    Copy link

    netlify bot commented Jan 20, 2025

    PS. Pls add /docs/nightly to the end of url

    Name Link
    🔨 Latest commit e753a23
    🔍 Latest deploy log https://app.netlify.com/sites/tyk-docs/deploys/678e3a15e2707200083bef44
    😎 Deploy Preview https://deploy-preview-5901--tyk-docs.netlify.app
    📱 Preview on mobile
    Toggle QR Code...

    QR Code

    Use your smartphone camera to open QR code link.

    To edit notification comments on pull requests, go to your Netlify site configuration.

    Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
    Projects
    None yet
    Development

    Successfully merging this pull request may close these issues.

    1 participant