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