docs: clarify behavior of bin/parse-legacy-file (#1424)

asdf-vm · Jan 9, 2023 · 1b62f4a · 1b62f4a
1 parent d6a4cbd
commit 1b62f4a
Showing 1 changed file with 1 addition and 1 deletion.
diff --git a/docs/plugins/create.md b/docs/plugins/create.md
@@ -127,7 +127,7 @@ Note: This will only apply for users who have enabled the `legacy_version_file`
 
 #### bin/parse-legacy-file
 
-This can be used to further parse the legacy file found by asdf. If `parse-legacy-file` isn't implemented, asdf will simply cat the file to determine the version. The script will be passed the file path as its first argument.
+This can be used to further parse the legacy file found by asdf. If `parse-legacy-file` isn't implemented, asdf will simply cat the file to determine the version. The script will be passed the file path as its first argument. Note that this script should be **deterministic** and always return the same exact version when parsing the same legacy file. The script should return the same version regardless of what is installed on the machine or whether the legacy version is valid or complete. Some legacy file formats may not be suitable.
 
 #### bin/post-plugin-add