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

[Plugin Hub] Display deprecated fields #7376

Merged
merged 6 commits into from
May 22, 2024

Conversation

fabianrbz
Copy link
Contributor

@fabianrbz fabianrbz commented May 14, 2024

Description

As of version 3.7.x, fields in the plugin schema have been flagged with a deprecation key, containing information about the deprecation.

  • Render a deprecation notice on deprecated fields
  • Remove Deprecated Parameters notice
  • Add a default deprecation notice to shorthand_fields if they don't have one.

Testing instructions

datadog - fields marked as deprecated
session - shorthand fields only (these weren't marked as deprecated)
forward-proxy - shorthand fields were marked as deprecated

Checklist

@fabianrbz fabianrbz added the review:general Review for general accuracy and presentation. Does the doc work? Does it output correctly? label May 14, 2024
@fabianrbz fabianrbz requested a review from a team as a code owner May 14, 2024 13:05
Copy link

netlify bot commented May 14, 2024

Deploy Preview for kongdocs ready!

Name Link
🔨 Latest commit 644b56c
🔍 Latest deploy log https://app.netlify.com/sites/kongdocs/deploys/664d9a356fb3e6000859979b
😎 Deploy Preview https://deploy-preview-7376--kongdocs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
9 paths audited
Performance: 95 (🟢 up 3 from production)
Accessibility: 93 (no change from production)
Best Practices: 98 (🟢 up 8 from production)
SEO: 91 (no change from production)
PWA: -
View the detailed breakdown and full score reports

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

@lena-larionova
Copy link
Contributor

See the changelog for this plugin for new field mapping info.

For shorthand fields, this makes sense. But looks like they're now listing the field mapping info directly in that deprecation notice. Maybe we should rephrase this? Something like: "If the deprecation notice for a parameter doesn't include new field mapping info, see the changelog."
What do you think?

@fabianrbz fabianrbz changed the title [Plugin Hub] Display deprecated fields at the bottom of the schema [Plugin Hub] Display deprecated fields May 15, 2024
@fabianrbz fabianrbz force-pushed the render-deprecation-notice-on-plugin-fields branch 3 times, most recently from d936762 to 4b463b6 Compare May 21, 2024 07:36
As of version 3.7.x, fields in the plugin schema have been flagged with
a `deprecation` key, containing information about the deprecation.

This commit adds the fields marked as deprecated to the list of
`Deprecated Parameters` on the Configuration Reference page.
It also renders a deprecation notice, with the information provided in
the field.

Note: Fields marked as deprecated are not rendered in the main body of
the schema, just in the `Deprecated Parameters` section.
And add a `Deprecation notice` to shorthand fields if they don't have
one.
@fabianrbz fabianrbz force-pushed the render-deprecation-notice-on-plugin-fields branch from 4b463b6 to ee56773 Compare May 21, 2024 08:55
Copy link
Contributor

@lena-larionova lena-larionova left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Couple of minor phrasing suggestions, otherwise lgtm

app/_includes/plugins/schemas/field.html Outdated Show resolved Hide resolved
app/_plugins/drops/plugins/schema.rb Outdated Show resolved Hide resolved
fabianrbz and others added 2 commits May 22, 2024 09:09
Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com>
Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com>
@fabianrbz fabianrbz merged commit 96e8f70 into main May 22, 2024
15 checks passed
@fabianrbz fabianrbz deleted the render-deprecation-notice-on-plugin-fields branch May 22, 2024 07:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
review:general Review for general accuracy and presentation. Does the doc work? Does it output correctly?
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants