diff --git a/dio/lib/src/file_access_mode.dart b/dio/lib/src/file_access_mode.dart
index 9d5dd25ec..ad74ddb4e 100644
--- a/dio/lib/src/file_access_mode.dart
+++ b/dio/lib/src/file_access_mode.dart
@@ -1,13 +1,14 @@
-/// {@template dio.FileAccessMode}
-///  The file access mode when downloading the file.
-/// - [FileAccessMode.write]: Mode for opening a file for reading and writing.
-///    The file is overwritten if it already exists. The file is created if it
-///    does not already exist
-/// - [FileAccessMode.append]: Mode for opening a file for reading and writing
-///    to the end of it. The file is created if it does not already exist.
+/// {@template dio.options.FileAccessMode}
+/// The file access mode when downloading a file, corresponds to a subset of 
+/// dart:io::[FileMode].
 /// {@endtemplate}
 enum FileAccessMode {
+  /// Mode for opening a file for reading and writing. The file is overwritten
+  /// if it already exists. The file is created if it does not already exist.
   write,
+
+  /// Mode for opening a file for reading and writing to the end of it.
+  /// The file is created if it does not already exist.
   append,
 }