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

Update tib 1.7.md #6007

Draft
wants to merge 3 commits into
base: master
Choose a base branch
from
Draft

Update tib 1.7.md #6007

wants to merge 3 commits into from

Conversation

JoanCamosTyk
Copy link
Contributor

@JoanCamosTyk JoanCamosTyk commented Feb 19, 2025

User description

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



Preview Link


Description


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.
  • For Tyk Members - Please add a Jira DX PR ticket to the subject!
  • For Tyk Members - I have added the appropriate release label to this PR:
    • If it is for a future release, label it as future-release and specify the version (e.g., future-release, 6.0).
    • If it should be merged into an older version, use the specific version label (e.g., 4.1, 5.1).
    • If no label is added, it will be assumed that the PR should be merged into the latest current version (e.g., 5.5) and master.

PR Type

Documentation


Description

  • Added detailed release notes for TIB version 1.7.

  • Included dependency compatibility matrix for third-party tools.

  • Provided upgrade instructions for users on older versions.

  • Added download links for Docker image and source code tarball.


Changes walkthrough 📝

Relevant files
Documentation
tib.md
Added TIB 1.7 release notes and related details                   

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

  • Added release notes for TIB version 1.7.
  • Included dependency compatibility matrix for GoLang, MongoDB, and
    Redis.
  • Provided upgrade instructions and download links for the release.
  • Clarified absence of breaking changes and deprecations.
  • +75/-0   

    Need help?
  • Type /help how to ... in the comments thread for any questions about PR-Agent usage.
  • Check out the documentation for more 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 Release Date

    The release date for version 1.7 is marked as xxxx. This placeholder should be replaced with the actual release date to ensure accuracy and completeness of the documentation.

    #### Release Date xxxx
    Dependency Compatibility Details

    The compatibility details for third-party dependencies (e.g., MongoDB, Redis) are provided, but it is unclear if these versions have been thoroughly tested or if there are any known issues. This should be validated and clarified.

    | Third Party Dependency                                     | Tested Versions        | Compatible Versions    | Comments | 
    | ---------------------------------------------------------- | ---------------------- | ---------------------- | -------- | 
    | [GoLang](https://go.dev/dl/)                               | 1.21       | 1.21       | All our binaries |
    | [MongoDB](https://www.mongodb.com/try/download/community)  | 5.x, 6.x, 7.0 | 4.4.x, 5.x, 6.x and 7.0.x | Used by Tyk Identity Broker |
    | [Redis](https://redis.io/download/)         | 6.x - 7.0        | 6.x - 7.0            | Used by Tyk Identity Broker |
    
    Given the time difference between your upgrade and the release of this version, we recommend customers verify the ongoing support of third-party dependencies they install, as their status may have changed since the release.

    Copy link
    Contributor

    PR Code Suggestions ✨

    Explore these optional code suggestions:

    CategorySuggestion                                                                                                                                    Impact
    General
    Populate the changelog with details

    Ensure the "Changelog" section includes specific features, updates, and fixed issues
    for version 1.7 to provide users with a clear understanding of the release's impact.

    tyk-docs/content/developer-support/release-notes/tib.md [86-93]

     #### Changelog {#Changelog-v1.7.0}
    -<!-- Required. The change log should include the following ordered set of sections below that briefly summarise the features, updates and fixed issues of the release.
    +- **Feature A**: Description of the feature and its benefits.
    +- **Update B**: Explanation of the update and its impact.
    +- **Fixed Issue C**: Details of the issue fixed and its resolution.
     
    -Here it is important to explain the benefit of each changelog item. As mentioned by James in a previous Slack message (https://tyktech.slack.com/archives/C044R3ZTN6L/p1686812207060839?thread_ts=1686762128.651249&cid=C044R3ZTN6L):
    -"...it is important to document the customer impact for the work delivered, so we can share it with prospects/install base. For example:
    -"New Chart delivers x and y benefit to a and b customer use cases. The business impact for them will be this and that" -->
    -
    Suggestion importance[1-10]: 4

    __

    Why: Adding specific features, updates, and fixed issues to the changelog provides clarity and value to users. However, the suggestion is not actionable as it requires detailed information about the release, which is not provided in the PR. The improvement is moderate but depends on external input.

    Low
    Add the missing release date

    Specify the release date for version 1.7 in the "Release Date xxxx" section to
    ensure clarity and completeness of the release notes.

    tyk-docs/content/developer-support/release-notes/tib.md [22]

    -#### Release Date xxxx
    +#### Release Date February 19, 2025
    Suggestion importance[1-10]: 3

    __

    Why: While specifying the release date improves the completeness of the release notes, the suggestion is not actionable as it requires external input (the actual release date). The improvement is minor and does not directly enhance functionality or correctness.

    Low

    Copy link

    netlify bot commented Feb 19, 2025

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

    Name Link
    🔨 Latest commit 2d67f0f
    🔍 Latest deploy log https://app.netlify.com/sites/tyk-docs/deploys/67b5ebbc0a7f2000080a7bf9
    😎 Deploy Preview https://deploy-preview-6007--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.

    Copy link

    netlify bot commented Feb 19, 2025

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

    Name Link
    🔨 Latest commit 4aa84d4
    🔍 Latest deploy log https://app.netlify.com/sites/tyk-docs/deploys/67b7235cef8f22000821a082
    😎 Deploy Preview https://deploy-preview-6007--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.

    @sharadregoti sharadregoti marked this pull request as draft February 20, 2025 09:15
    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