From 3b76ca802b7d1a90ae2c42bd5b54a28ba6433ffa Mon Sep 17 00:00:00 2001
From: Gabriel Grubba <70247653+Grubba27@users.noreply.github.com>
Date: Tue, 22 Aug 2023 11:25:03 -0300
Subject: [PATCH 1/4] docs: added known issues section for 2.13

---
 docs/_config.yml            |  1 +
 docs/source/known-issues.md | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+)
 create mode 100644 docs/source/known-issues.md

diff --git a/docs/_config.yml b/docs/_config.yml
index d8706c14f7..ae271e28c7 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -95,6 +95,7 @@ sidebar_categories:
   Troubleshooting:
     - expired-certificate
     - windows
+    - known-issues
 github_repo: 'meteor/meteor'
 edit_branch: 'devel'
 edit_path: 'docs'
diff --git a/docs/source/known-issues.md b/docs/source/known-issues.md
new file mode 100644
index 0000000000..4a0d0ab7ce
--- /dev/null
+++ b/docs/source/known-issues.md
@@ -0,0 +1,33 @@
+---
+title: Known issues in 2.13
+description: Troubleshooting in Meteor 2.13
+---
+
+<h2 id="cannot-extract-meteor-tool">Cannot extract version of meteor tool</h2>
+
+For some users, the `meteor update` to version 2.13 command may fail with the following error or similar:
+
+```shell
+Error: incorrect data check
+    at Zlib.zlibOnError [as onerror] (zlib.js:187:17)
+ => awaited here:
+ ...
+    at /tools/cli/main.js:1165:7 {
+  errno: -3,
+  code: 'Z_DATA_ERROR'
+  }
+
+```
+
+You can follow along with the [GitHub issue](https://github.com/meteor/meteor/issues/12731) for updates.
+
+The workaround while our developers are working in this issue is:
+
+running the following command in you terminal:
+
+```shell
+
+curl https://install.meteor.com/\?release\=2.12 | sh
+
+```
+

From be0929d8fa21881bec2e881c144b8bb698596315 Mon Sep 17 00:00:00 2001
From: Gabriel Grubba <70247653+Grubba27@users.noreply.github.com>
Date: Tue, 22 Aug 2023 11:36:16 -0300
Subject: [PATCH 2/4] Update docs/source/known-issues.md

Co-authored-by: Henrique A. Schmaiske <59376543+henriquealbert@users.noreply.github.com>
---
 docs/source/known-issues.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/source/known-issues.md b/docs/source/known-issues.md
index 4a0d0ab7ce..d76d6f6739 100644
--- a/docs/source/known-issues.md
+++ b/docs/source/known-issues.md
@@ -21,7 +21,7 @@ Error: incorrect data check
 
 You can follow along with the [GitHub issue](https://github.com/meteor/meteor/issues/12731) for updates.
 
-The workaround while our developers are working in this issue is:
+The workaround while our developers are working on this issue is as follows:
 
 running the following command in you terminal:
 

From d28df2739dc7cb5da76048822daa8a7698359fb7 Mon Sep 17 00:00:00 2001
From: Gabriel Grubba <70247653+Grubba27@users.noreply.github.com>
Date: Tue, 22 Aug 2023 11:36:22 -0300
Subject: [PATCH 3/4] Update docs/source/known-issues.md

Co-authored-by: Henrique A. Schmaiske <59376543+henriquealbert@users.noreply.github.com>
---
 docs/source/known-issues.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/source/known-issues.md b/docs/source/known-issues.md
index d76d6f6739..81e216e6e4 100644
--- a/docs/source/known-issues.md
+++ b/docs/source/known-issues.md
@@ -23,7 +23,7 @@ You can follow along with the [GitHub issue](https://github.com/meteor/meteor/is
 
 The workaround while our developers are working on this issue is as follows:
 
-running the following command in you terminal:
+running the following command in your terminal:
 
 ```shell
 

From 571926b4463c107d1d51e17e11b8af955b97c298 Mon Sep 17 00:00:00 2001
From: Gabriel Grubba <70247653+Grubba27@users.noreply.github.com>
Date: Tue, 22 Aug 2023 11:59:00 -0300
Subject: [PATCH 4/4] docs: added more context

---
 docs/source/known-issues.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/source/known-issues.md b/docs/source/known-issues.md
index 81e216e6e4..584464b279 100644
--- a/docs/source/known-issues.md
+++ b/docs/source/known-issues.md
@@ -18,9 +18,15 @@ Error: incorrect data check
   }
 
 ```
+<h3 id="the-issue"> The issue </h3>
+
+It seems related to [our first ESM version of Node.js v14.21.4](https://github.com/meteor/node-v14-esm) and the `zlib` package.
+We have been able to reproduce this issue only in Mac Intel.
 
 You can follow along with the [GitHub issue](https://github.com/meteor/meteor/issues/12731) for updates.
 
+<h3 id="workaround"> Workaround </h3>
+
 The workaround while our developers are working on this issue is as follows:
 
 running the following command in your terminal: