Document crate-specific overrides

build.nix

@@ -68,6 +68,7 @@
 , fetchurl
 , lndir
 , userAttrs
+  #| Some additional buildInputs/overrides individual crates require
 , crateSpecificOverrides
 , pkgs
 }:
@@ -378,6 +379,11 @@ let
     };
   };
 
+  # Crate-specific overrides needed for this build.
+  # They are merged from all the overrides of `cratesIoDependencies` defined in the `crate_specific.nix` file
+  #
+  # This can contain fields: `buildInputs`, `nativeBuildInputs`
+  # When changing them (eg. adding support for new ones/removing some), also update the comment in the `crate_specific.nix` file
   neededCrateSpecificOverrides =
     let
       overridesList = builtins.map

crate_specific.nix

@@ -1,3 +1,11 @@
+# This file contains crate-specific build inputs.
+#
+# Each of them is an attribute with name of the crate and value being a function.
+# This function gets as arguments:
+#  - `crateInfo` with information about the crate, such as sha256 or version
+#
+# Currently supported fields to return are: `buildInputs`, `nativeBuildInputs`
+
 { pkgs }:
 
 {