Update docs/comments

Author: taiki-e

.clippy.toml

@@ -8,7 +8,7 @@ disallowed-macros = [
     { path = "std::dbg", reason = "it is okay to use during development, but please do not include it in main branch" },
 ]
 disallowed-methods = [
-    # Since we are using fs-err crate (as `fs`), `fs::*` functions will output a better error.
+    # For better error messages, we use crate::fs for bin/lib and fs-err crate (imported as `fs`) for test.
     { path = "std::fs::canonicalize", replacement = "fs::canonicalize" },
     { path = "std::fs::copy", replacement = "fs::copy" },
     { path = "std::fs::create_dir_all", replacement = "fs::create_dir_all" },
@@ -27,16 +27,23 @@ disallowed-methods = [
     { path = "std::fs::set_permissions", replacement = "fs::set_permissions" },
     { path = "std::fs::symlink_metadata", replacement = "fs::symlink_metadata" },
     { path = "std::fs::write", replacement = "fs::write" },
+    # { path = "std::os::unix::fs::symlink", replacement = "fs::os::unix::fs::symlink" },
+    # { path = "std::os::windows::fs::symlink_dir", replacement = "fs::os::windows::fs::symlink_dir" },
+    # { path = "std::os::windows::fs::symlink_file", replacement = "fs::os::windows::fs::symlink_file" },
     { path = "std::path::Path::canonicalize", replacement = "fs::canonicalize" },
     { path = "std::path::Path::metadata", replacement = "fs::metadata" },
     { path = "std::path::Path::read_dir", replacement = "fs::read_dir" },
     { path = "std::path::Path::read_link", replacement = "fs::read_link" },
     { path = "std::path::Path::symlink_metadata", replacement = "fs::symlink_metadata" },
 ]
 disallowed-types = [
-    # Since we are using fs-err crate (as `fs`), `fs::*` types will output a better error.
+    # For better error messages, we use crate::fs for bin/lib and fs-err crate (imported as `fs`) for test.
     { path = "std::fs::DirEntry", replacement = "fs::DirEntry" },
     { path = "std::fs::File", replacement = "fs::File" },
     { path = "std::fs::OpenOptions", replacement = "fs::OpenOptions" },
     { path = "std::fs::ReadDir", replacement = "fs::ReadDir" },
+    # { path = "std::os::unix::fs::FileExt", replacement = "fs::os::unix::fs::FileExt" },
+    # { path = "std::os::unix::fs::OpenOptionsExt", replacement = "fs::os::unix::fs::OpenOptionsExt" },
+    # { path = "std::os::windows::fs::FileExt", replacement = "fs::os::windows::fs::FileExt" },
+    # { path = "std::os::windows::fs::OpenOptionsExt", replacement = "fs::os::windows::fs::OpenOptionsExt" },
 ]

README.md

@@ -838,7 +838,7 @@ This makes the installation faster and may avoid the impact of [problems caused
 
 When used with [nextest]:
 
-```yml
+```yaml
 - uses: taiki-e/install-action@cargo-llvm-cov
 - uses: taiki-e/install-action@nextest
 ```