docs: troubleshooting (#76)

* docs: troubleshooting --------- Co-authored-by: Mikhail Shipov <[email protected]>
Tinkoff · Mar 6, 2023 · d1385e9 · d1385e9
1 parent ef6edca
commit d1385e9
Show file tree

Hide file tree

Showing 3 changed files with 31 additions and 0 deletions.
diff --git a/website/docs/troubleshooting/eneedauth.md b/website/docs/troubleshooting/eneedauth.md
@@ -0,0 +1,24 @@
+---
+id: eneedauth
+title: ENEEDAUTH
+---
+
+## Error
+
+Publication failure:
+
+```
+Error: Command "npm publish ./package --tag latest --registry https://registry.npmjs.org/ --unsafe-perm"
+...
+npm ERR! code ENEEDAUTH
+npm ERR! need auth This command requires you to be logged in to https://registry.npmjs.org/
+npm ERR! need auth You need to authorize this machine using `npm adduser`   
+```
+
+## Reason
+
+In Node.js after 18.14.0 version npm was upgraded to major 9.3.1 version - https://github.com/nodejs/node/blob/main/doc/changelogs/CHANGELOG_V18.md#auth, which broke authorization logic in pvm
+
+## Solution
+
+Stick to  18.13 node version - `node:18.13.0` until https://github.com/Tinkoff/pvm/issues/75
diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
@@ -81,6 +81,10 @@ const siteConfig = {
           to: 'docs/how-to/move-to-dedicated-versions',
           label: 'How-To',
         },
+        {
+          to: 'docs/troubleshooting/eneedauth',
+          label: 'Troubleshooting',
+        },
         {
           label: 'References',
           to: `docs/api/modules/pvm_pvm`,

diff --git a/website/sidebars.js b/website/sidebars.js
@@ -41,6 +41,9 @@ module.exports = {
       'how-to/local-releases',
       'how-to/update-hints',
     ],
+    'Troubleshooting': [
+      'troubleshooting/eneedauth',
+    ],
   },
   'API': [
     {