3rd Party SDK component function deprecation Plan

[jpvajda]

on December 31st 2020 February 28th 2021 the following will be deprecated:

• Dropdown component cannot use “label” anymore.

currently marked as deprecated on dec 31

• AccountPicker “onChange” listener is passing “accountId” as the second argument.

currently the example shows the new way it's done, but the props section shows the old deprecated way

• Icon “sizeType” is deprecated (icons render on their specific size they were created)

currently marked as deprecated on dec 31

• EntityTitleTableRowCell “reporting” inside “value” is mandatory now.

already set as required

• Tooltip is losing “className” and “style” If you want to tweak the container add an extra node.

component makes no mention of this being expired on Dec 31

• TableRow “actions” don’t accept “iconType” anymore.

component makes no mention of this being expired on Dec 31

The plan

All deprecations follow a 1-year process that involves console logging for the first 11 months (first as log, followed by warn, followed by error), and for the last month a red toast with the "Deprecation" title and the message below, in case you never opened the console. Documentation also get an deprecated tag explaining the reasoning behind it.

We can also do a internal post on Nerdlife and a Discuss post as well as updating the developer site for 3rd party developers with the changes. We can coordinate pulling in the function and prop  updates from a 3rd party bundle.

AC

• consider how these changes will impact the dev site and put a plan in place to address it.
• determine how we'll update the core components from the SDK bundle.
• ask Miguel to pull global app owners from artifact registry.
• Work with @tangollama to find a way to automate this GH Issue using Replinter.
• post nerdlife post about these changes.
• post discuss post about these changes.
• Share post with #wizard programmablity slack channel
• Setup Office hours for Field Sales Teams to get questions answered
• Notify all Field Sales leaders of this change via email
• update any guides that may be using deprecated functionality.
• Integrate with a proper 3rd party bundle that can keep our site up to date with the core changes. GH Issue

Possible Guide updates

https://developer.newrelic.com/build-apps/add-nerdgraphquery-guide

This guide mentions account selection in step 2.

https://developer.newrelic.com/build-apps/howto-use-nrone-table-components

this guide uses TableRow Actions with iconType in step 8

[jpvajda]

I've reached out @mjesun about obtaining an update SDK bundle for the component changes so we can import that into the Dev Site. All guides can be updated when the official changes are in place.

[jpvajda]

@alexronquillo just an FYI on this change...

[jpvajda]

confirmed these actually will be deprecated on Feb 28th, not Dec 31st

[jpvajda]

#895

[jpvajda]

Dev Site updated with new components: #1070

[jpvajda]

all guides look good, components are updated on the dev site as well.

[jpvajda]

Marking this issue as done as all work is being track on this project board for 3rd party apps. https://github.com/orgs/newrelic/projects/44