Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Dec 10, 2025

Description

Why

Cuts documentation for React Native Windows 0.81 release following the established versioning process. Creates versioned snapshot for 0.81 as the new default documentation version.

Changes

  • Version snapshot: Created version-0.81 with current docs (getting-started, migration-guide, native-platform-getting-started)
  • Configuration updates:
    • versions.json: Added 0.81 at top
    • siteConfig.js: Set defaultVersionShown to "0.81"
    • support.js: Added 0.81 entry (TBD dates), moved 0.80 to v0.80-stable tag
  • Version-0.81 docs: Updated to use @latest CLI and ^0.81.0 package versions (changed from @next/nightly/canary)
  • migration-guide.md: Fixed spelling error by restructuring sentence to avoid markdown-spellcheck parser issue
  • .unbroken_exclusions: Added 0.81 native-api exclusion
  • .spelling: Added 0.81 version ID patterns

Website builds successfully and spell check passes.

Screenshots

N/A - Documentation version upgrade only

Original prompt

This section details on the original issue you should resolve

<issue_title>Upgrade Website to 0.81</issue_title>
<issue_description>Refer this https://github.com/microsoft/react-native-windows-samples/blob/main/website/README.md and these are the PR for previous releases.

PR for 0.79: https://github.com/microsoft/react-native-windows-samples/pull/1042/files
PR for 0.80: https://github.com/microsoft/react-native-windows-samples/issues/1072/files

Do similar changes for 0.81.
The commands for that would be:

Cutting Documentation for a New React Native Windows Release

  1. Update necessary version references in docs.

    1. getting-started.md - make sure to update from "nightly" to "latest" and change the previous stable version from "latest" to "0.XX-stable" in react-native init.
  2. Follow the Integration into the react-native-windows-samples-repo steps to add the latest API documentation.

  3. If win10-compat.md has changed since the last version cut, copy contents of docs/win10-compat.md:

    1. The oldest version of win10-compat.md in versioned_docs should be replaced with the one from docs. Make sure to adjust the page id to match the older version.
    2. Confirm all other old versions of win10-compat.md should be deleted.
  4. Snapshot the website for version 0.XX:

    1. cd website
    2. yarn run version 0.XX
    3. yarn run fix-unbroken

    This will create a new directory of versioned docs, version-0.XX, in website/versioned_docs. This will preserve all documents currently in the docs directory and make them available as documentation for version 0.XX. For more information on versioning, click here.

  5. Edit website/.unbroken_exclusions and add the line !versioned_docs/version-0.XX/native-api/*-api-windows*.md underneath the other versioned doc exclusions listed at the top of the file.

  6. Update support.js and add/update the entry for the new version of React Native Windows with the correct release and Active Support Start Date X (ex: 6/27/22). Then make sure to edit the previous version's:

    1. Maintenance Start Date (set to the last day of the month that's 1 month out from X, ex: 7/31/22)
    2. End of Support Date (set to the last day of the month that's 2 months out from X, ex: 9/30/22)
  7. When you are ready for your new docs to be the default documentation on the website, edit website/siteConfig.js to point to 0.XX for its defaultVersionShown constant.

Once all changes are done, run " npx markdown-spellcheck "website/versioned_docs//*.md" "!website/versioned_docs//-api-windows.md" --en-us --ignore-acronyms --ignore-numbers --report --color
"

and add all the spelling errors to .spelling file</issue_description>

<agent_instructions>Look into the description and create a website for 0.81</agent_instructions>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Microsoft Reviewers: Open in CodeFlow

Copilot AI and others added 2 commits December 10, 2025 10:18
Co-authored-by: vineethkuttan <66076509+vineethkuttan@users.noreply.github.com>
Co-authored-by: vineethkuttan <66076509+vineethkuttan@users.noreply.github.com>
@vineethkuttan
Copy link
Contributor

image image

Tested Manually and it is working fine.

Copilot AI and others added 2 commits December 10, 2025 10:38
Co-authored-by: vineethkuttan <66076509+vineethkuttan@users.noreply.github.com>
Co-authored-by: vineethkuttan <66076509+vineethkuttan@users.noreply.github.com>
@vineethkuttan vineethkuttan changed the title [WIP] Update website documentation for version 0.81 Update website documentation for version 0.81 Dec 10, 2025
Copilot AI changed the title Update website documentation for version 0.81 Upgrade Website to 0.81 Dec 10, 2025
Copilot AI requested a review from vineethkuttan December 10, 2025 10:58
@vineethkuttan
Copy link
Contributor

@copilot remove all win10 compat changes.

Co-authored-by: vineethkuttan <66076509+vineethkuttan@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Dec 10, 2025

@copilot remove all win10 compat changes.

Reverted all win10-compat changes in commit f6245ae. The version-0.60 file has been restored to its original state, and the deleted files (0.68, 0.72, 0.75, 0.76, 0.79) have been restored.

@vineethkuttan
Copy link
Contributor

@copilot remove all the spelling error by following this

Run npx markdown-spellcheck "website/versioned_docs//*.md" "!website/versioned_docs//-api-windows.md" --en-us --ignore-acronyms --ignore-numbers --report --color
website/versioned_docs/version-0.81/migration-guide.md
16 | lt renderer starting with RNW v0.80. This migration guide applies

1 spelling error found in 267 files

Co-authored-by: vineethkuttan <66076509+vineethkuttan@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Dec 10, 2025

@copilot remove all the spelling error by following this

Run npx markdown-spellcheck "website/versioned_docs//*.md" "!website/versioned_docs//-api-windows.md" --en-us --ignore-acronyms --igno...

Fixed the spelling error in commit 848adbb by restructuring the sentence in migration-guide.md. The markdown-spellcheck parser was incorrectly splitting "default" in the Note section. Changed "Fabric became the default renderer starting with RNW v0.80" to "Starting with RNW v0.80, Fabric became the default renderer" to avoid the parsing issue. Spell check now passes for version-0.81 docs.

@vineethkuttan vineethkuttan changed the title Upgrade Website to 0.81 [Do Not Merge] Upgrade Website to 0.81 Dec 11, 2025
@vineethkuttan vineethkuttan marked this pull request as ready for review December 11, 2025 16:23
@vineethkuttan vineethkuttan requested a review from a team as a code owner December 11, 2025 16:23
| [main](https://www.npmjs.com/package/react-native-windows/v/canary) | [Canary](#canary-support) | *N/A* | *N/A* | *N/A* | *N/A* |
| [0.80](https://www.npmjs.com/package/react-native-windows/v/latest) | [Active](#active-support) | 10/28/2025 | 10/28/2025 | *TBD* | *TBD* |
| [0.81](https://www.npmjs.com/package/react-native-windows/v/latest) | [Active](#active-support) | *TBD* | *TBD* | *TBD* | *TBD* |
| [0.80](https://www.npmjs.com/package/react-native-windows/v/v0.80-stable) | [Active](#active-support) | 10/28/2025 | 10/28/2025 | *TBD* | *TBD* |

Choose a reason for hiding this comment

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

This needs to be updated

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Upgrade Website to 0.81

3 participants