Add how-to guide for node's test runner (#6770)

* Add how-to guide for node's test runner

Signed-off-by: Jacob Smith <[email protected]>

* adjust markdown to special flavour

Co-authored-by: Augustin Mauroy <[email protected]>
Signed-off-by: Jacob Smith <[email protected]>

* fix: code snippet

* chore(learn-content): add introduction for test-runner

* chore(navigation): add learn entry

* feedback on the formulation

Co-authored-by: Jacob Smith <[email protected]>
Signed-off-by: Augustin Mauroy <[email protected]>

* Update i18n/locales/en.json

Co-authored-by: Michael Esteban <[email protected]>
Signed-off-by: Augustin Mauroy <[email protected]>

* Update navigation.json

Co-authored-by: Michael Esteban <[email protected]>
Signed-off-by: Augustin Mauroy <[email protected]>

* fix grammar

Co-authored-by: Michael Esteban <[email protected]>
Signed-off-by: Augustin Mauroy <[email protected]>

* fix: npm init command

---------

Signed-off-by: Jacob Smith <[email protected]>
Signed-off-by: Augustin Mauroy <[email protected]>
Co-authored-by: Augustin Mauroy <[email protected]>
Co-authored-by: Michael Esteban <[email protected]>
Co-authored-by: Augustin Mauroy <[email protected]>

Author: 3 people

i18n/locales/en.json

@@ -97,6 +97,13 @@
             "poorPerformance": "Poor Performance",
             "flameGraphs": "Flame Graphs"
           }
+        },
+        "testRunner": {
+          "links": {
+            "testRunner": "Test Runner",
+            "introduction": "Discovering Node.js's test runner",
+            "usingTestRunner": "Using Node.js's test runner"
+          }
         }
       },
       "about": {

navigation.json

@@ -330,48 +330,61 @@
               "label": "components.navigation.learn.diagnostics.links.flameGraphs"
             }
           }
-        }
-      }
-    },
-    "download": {
-      "items": {
-        "shaSums": {
-          "link": "https://nodejs.org/dist/{nodeVersion}/SHASUMS256.txt.asc",
-          "label": "components.downloadList.links.shaSums.title"
-        },
-        "allDownloads": {
-          "link": "https://nodejs.org/dist/{nodeVersion}/",
-          "label": "components.downloadList.links.allDownloads"
-        },
-        "packageManager": {
-          "link": "/download/package-manager",
-          "label": "components.downloadList.links.packageManager"
-        },
-        "previousReleases": {
-          "link": "/about/previous-releases",
-          "label": "components.downloadList.links.previousReleases"
-        },
-        "nightlyReleases": {
-          "link": "https://nodejs.org/download/nightly/",
-          "label": "components.downloadList.links.nightlyReleases"
         },
-        "unofficialBuilds": {
-          "link": "https://unofficial-builds.nodejs.org/download/",
-          "label": "components.downloadList.links.unofficialBuilds"
-        },
-        "buildingFromSource": {
-          "link": "https://github.com/nodejs/node/blob/main/BUILDING.md#building-nodejs-on-supported-platforms",
-          "label": "components.downloadList.links.buildingFromSource"
-        },
-        "installingOnLinux": {
-          "link": "https://github.com/nodejs/help/wiki/Installation",
-          "label": "components.downloadList.links.installingOnLinux"
-        },
-        "installingOnWsl": {
-          "link": "https://github.com/nodejs/node/blob/main/BUILDING.md#building-nodejs-on-supported-platforms",
-          "label": "components.downloadList.links.installingOnWsl"
+        "testRunner": {
+          "label": "components.navigation.learn.testRunner.links.testRunner",
+          "items": {
+            "introduction": {
+              "link": "/learn/test-runner/introduction",
+              "label": "components.navigation.learn.testRunner.links.introduction"
+            },
+            "usingTestRunner": {
+              "link": "/learn/test-runner/using-test-runner",
+              "label": "components.navigation.learn.testRunner.links.usingTestRunner"
+            }
+          }
         }
       }
     }
+  },
+  "download": {
+    "items": {
+      "shaSums": {
+        "link": "https://nodejs.org/dist/{nodeVersion}/SHASUMS256.txt.asc",
+        "label": "components.downloadList.links.shaSums.title"
+      },
+      "allDownloads": {
+        "link": "https://nodejs.org/dist/{nodeVersion}/",
+        "label": "components.downloadList.links.allDownloads"
+      },
+      "packageManager": {
+        "link": "/download/package-manager",
+        "label": "components.downloadList.links.packageManager"
+      },
+      "previousReleases": {
+        "link": "/about/previous-releases",
+        "label": "components.downloadList.links.previousReleases"
+      },
+      "nightlyReleases": {
+        "link": "https://nodejs.org/download/nightly/",
+        "label": "components.downloadList.links.nightlyReleases"
+      },
+      "unofficialBuilds": {
+        "link": "https://unofficial-builds.nodejs.org/download/",
+        "label": "components.downloadList.links.unofficialBuilds"
+      },
+      "buildingFromSource": {
+        "link": "https://github.com/nodejs/node/blob/main/BUILDING.md#building-nodejs-on-supported-platforms",
+        "label": "components.downloadList.links.buildingFromSource"
+      },
+      "installingOnLinux": {
+        "link": "https://github.com/nodejs/help/wiki/Installation",
+        "label": "components.downloadList.links.installingOnLinux"
+      },
+      "installingOnWsl": {
+        "link": "https://github.com/nodejs/node/blob/main/BUILDING.md#building-nodejs-on-supported-platforms",
+        "label": "components.downloadList.links.installingOnWsl"
+      }
+    }
   }
 }

pages/en/learn/test-runner/introduction.md

@@ -0,0 +1,23 @@
+---
+title: Discovering Node.js's test runner
+layout: learn
+authors: AugustinMauroy
+---
+
+# Discovering Node.js's test runner
+
+In this series of resources, we will discover how to use Node.js's test runner to test our code.
+
+## What is a test runner?
+
+A test runner is a tool that allows you to run tests on your code. It will execute your tests and give you feedback on whether they pass or fail. It can also provide you with additional information such as code coverage.
+
+There are many test runners available for Node.js, but we will focus on the built-in test runner that comes with Node.js. It's cool because you don't need to install any additional dependencies to use it.
+
+## Why test your code?
+
+Testing your code is important because it allows you to verify that your code works as expected. It helps you catch bugs early in the development process and ensures that your code is reliable and maintainable.
+
+## Running tests with Node.js
+
+To run tests with Node.js, we recommend you to read the [test runner documentation](https://nodejs.org/docs/latest/api/test.html#test-runner).