From 014c28c5f536689382c84545a58a474b4ab20407 Mon Sep 17 00:00:00 2001
From: SheetJS <dev@sheetjs.com>
Date: Mon, 13 Nov 2023 18:19:19 -0500
Subject: [PATCH] win10

---
 docz/docs/09-miscellany/05-contributing.md | 41 ++++++++++++++++++++--
 1 file changed, 38 insertions(+), 3 deletions(-)

diff --git a/docz/docs/09-miscellany/05-contributing.md b/docz/docs/09-miscellany/05-contributing.md
index 5b555bb..a8c254a 100644
--- a/docz/docs/09-miscellany/05-contributing.md
+++ b/docz/docs/09-miscellany/05-contributing.md
@@ -43,7 +43,7 @@ These instructions were tested on the following platforms:
 | Linux (Ubuntu 18 AArch64)     | 2023-09-07 |
 | MacOS 10.13.6 (x64)           | 2023-09-30 |
 | MacOS 13.6 (ARM64)            | 2023-09-30 |
-| Windows 10 (x64) + WSL Ubuntu | 2023-07-23 |
+| Windows 10 (x64) + WSL Ubuntu | 2023-11-13 |
 | Windows 11 (x64) + WSL Ubuntu | 2023-10-14 |
 | Windows 11 (ARM) + WSL Ubuntu | 2023-09-18 |
 
@@ -79,6 +79,12 @@ The following command installs Ubuntu within WSL:
 wsl --install Ubuntu
 ```
 
+In some versions of `wsl`, the `-d` flag must be specified:
+
+```powershell
+wsl --install -d Ubuntu
+```
+
 :::caution pass
 
 In the last Windows 11 test, there was a `WSL_E_DEFAULT_DISTRO_NOT_FOUND` error.
@@ -183,6 +189,25 @@ git clone https://git.sheetjs.com/sheetjs/js-crc32
 
 :::note pass
 
+On Windows 10, this clone may fail due to issues with `core.filemode`:
+
+```
+fatal: could not set 'core.filemode' to 'false'
+```
+
+The main drive must be remounted with the metadata option:
+
+```bash
+cd /
+sudo umount /mnt/c
+sudo mount -t drvfs C: /mnt/c -o metadata
+cd -
+```
+
+:::
+
+:::note pass
+
 If this clone fails with an error message that mentions SSL or secure connection
 or certificates, build and install a version of Git with proper SSL support:
 
@@ -393,10 +418,19 @@ to work and known to produce consistent results.
 2) Initialize the test files:
 
 ```bash
-make init
+rmdir test_files
+curl -LO https://test-files.sheetjs.com/test_files.zip
+unzip test_files.zip
+mkdir -p tmp
 ```
 
-This step may take a while as it will be downloading a number of test files.
+:::note pass
+
+The `rmdir` command may fail if the folder is missing. The error can be ignored.
+
+:::
+
+This step may take a few minutes as the current test snapshot is large.
 
 3) Run the `esbuild` tool once:
 
@@ -533,6 +567,7 @@ curl -L https://cdn.sheetjs.com/xlsx-0.20.0/package/dist/xlsx.full.min.js | md5s
 
 When the demo was last tested on macOS, against version `0.20.0`:
 
+>
 ```bash
 $ md5 dist/xlsx.full.min.js
 # highlight-next-line