react-native-windows-samples icon indicating copy to clipboard operation
react-native-windows-samples copied to clipboard

Document RNW version support matrix

Open chrisglein opened this issue 4 years ago • 4 comments

Summary

As RNW moves forward from version to version, from 0.59 to 0.60 to 0.61 to 0.62... not all of these versions get uniform support. There will be caveats for each. And we should document those.

Motivation

Create clarity for app developers about what risks they are taking on for staying on each particular version.

Open Questions

  • How should we communicate this? Table of combinations that are/aren't supported?
  • How can we track which customers are on which versions so we can be knowledgeable about how we do deprecations

chrisglein avatar Jun 12 '20 19:06 chrisglein

In addition to versions, we need to be clear about:

  • some features are only available in some OS versions (we capture some of this but not exhaustively, e.g. animations only work on RS5+)
  • consuming RNW via source vs. nuget (office) vs. loose binary (stellar)
  • how do we ensure we are able to keep building older versions, in light of AzDO updating VS versions out from under us?

We also need a process to shepherd customers onto the "most supported" version (i.e. if we don't want to continue supporting 0.60, someone needs to be prodding them esp for internal customers). For example,

  • do we create DLs for internal users on older releases?
  • we probably need telemetry to capture what version is being used. In the CLI? In the framework?

asklar avatar Jun 15 '20 08:06 asklar

some features are only available in some OS versions (we capture some of this but not exhaustively, e.g. animations only work on RS5+)

We need to make this discoverable and update it: https://microsoft.github.io/react-native-windows/docs/win10-compat

chrisglein avatar Jun 15 '20 18:06 chrisglein

We need to make this discoverable and update it: https://microsoft.github.io/react-native-windows/docs/win10-compat

I updated it with the OS version support in the bottom, and the table with 0.62 added is ready for the website bump: https://microsoft.github.io/react-native-windows/docs/next/win10-compat

Related issues:

https://github.com/microsoft/react-native-windows-samples/issues/36 https://github.com/microsoft/react-native-windows-samples/issues/59 https://github.com/microsoft/react-native-windows/issues/5043

jonthysell avatar Jun 15 '20 21:06 jonthysell

Notes from discussion

  • different levels of support for security vs. features

  • external customers are on 62

  • samples apps on 61 - need to update

  • community modules on 61? should be already working on 62

  • once we have gallery app, make sure it works with a new release

  • core set of community modules that are supported

  • diff level of support than windows, winui, etc.

  • our level of support is more similar to RN Core

  • add supported/unsupported onto https://microsoft.github.io/react-native-windows/versions

  • add release date to https://microsoft.github.io/react-native-windows/versions

asklar avatar Jun 29 '20 17:06 asklar

https://microsoft.github.io/react-native-windows/support

chrisglein avatar Oct 10 '23 16:10 chrisglein