test: add descriptions for integration tests

tests/integration/tests/nodejs_built-binary/flake.nix

@@ -1,3 +1,16 @@
+# test: node.js built binary
+#
+# Detecting regressions of #235.
+#
+# Node.js builder was crashing if a binary defined in package.json
+# bin section refers to a file that does not exist before the build step.
+#
+# 1. "package.json".bin.main = "./main.js"
+# 2. `main.js` does not exist, but is created during the build
+# 3. the default build script "package.json".scripts.build creates `main.js`
+#    during the buildPhase
+# 4. the binary is linked to the bin directory in the installPhase
+#
 {
   inputs = {
     dream2nix.url = "github:nix-community/dream2nix";

tests/integration/tests/nodejs_direct-priority-over-transitive/flake.nix

@@ -1,3 +1,17 @@
+# test: node.js direct dep priority over transitive dep
+#
+# Detecting regressions for #221.
+#
+# Node.js builder was linking the wrong version of a binary,
+# if there was another dependency transitivelly depending on another version,
+# this one would be resolved instead of the direct dependency.
+#
+# Dependencies: svgo@2, cssnano@4 (cssnano@4 -> svgo@1)
+#
+# 1. Dream2Nix normal build.
+# 2. Get version of svgo in node.js path. (npm run get-version = svgo --version)
+# 3. Check if this is the same version as the direct dependency.
+#
 {
   inputs = {
     dream2nix.url = "github:nix-community/dream2nix";