💬 Comments update with grammar correction.

Author: AlexV525

lib/src/constants/zoom_page_transition.dart

@@ -4,8 +4,7 @@
 ///
 import 'package:flutter/material.dart';
 
-// Zooms and fades a new page in, zooming out the previous page. This transition
-// is designed to match the Android 10 activity transition.
+// TODO(Alex): Implement new transition after the new one released.
 class ZoomPageTransition extends StatefulWidget {
   const ZoomPageTransition({
     Key key,
@@ -14,14 +13,11 @@ class ZoomPageTransition extends StatefulWidget {
     this.child,
   }) : super(key: key);
 
-  // The scrim obscures the old page by becoming increasingly opaque.
   static final Tween<double> _scrimOpacityTween = Tween<double>(
     begin: 0.0,
     end: 0.60,
   );
 
-  // A curve sequence that is similar to the 'fastOutExtraSlowIn' curve used in
-  // the native transition.
   static final List<TweenSequenceItem<double>>
       fastOutExtraSlowInTweenSequenceItems = <TweenSequenceItem<double>>[
     TweenSequenceItem<double>(
@@ -61,10 +57,6 @@ class _ZoomPageTransitionState extends State<ZoomPageTransition> {
     });
   }
 
-  // This check ensures that the animation reverses the original animation if
-  // the transition were interruped midway. This prevents a disjointed
-  // experience since the reverse animation uses different fade and scaling
-  // curves.
   bool get _transitionWasInterrupted {
     bool wasInProgress = false;
     bool isInProgress = false;

lib/src/delegates/text_delegate.dart

@@ -6,7 +6,7 @@
 /// Text delegate that controls text in widgets.
 /// 控制部件中的文字实现
 abstract class TextDelegate {
-  /// Confirm string for confirm button.
+  /// Confirm string for the confirm button.
   /// 确认按钮的字段
   String confirm;
 
@@ -18,7 +18,7 @@ abstract class TextDelegate {
   /// 编辑按钮的字段
   String edit;
 
-  /// Placeholder when there's nothing can displayed in the picker.
+  /// Placeholder when there's nothing can display in the picker.
   /// 选择器没有可显示的内容时的占位字段
   String emptyPlaceHolder;
 
@@ -46,12 +46,12 @@ abstract class TextDelegate {
   /// 选择按钮的字段
   String select;
 
-  /// Un-supported asset type string for asset that belongs to [AssetType.other].
+  /// Un-supported asset type string for assets that belongs to [AssetType.other].
   /// 未支持的资源类型的字段
   String unSupportedAssetType;
 
-  /// This is used in video asset item in picker, in order to display
-  /// the duration of the video or audio type of asset.
+  /// This is used in video asset item in the picker, in order
+  /// to display the duration of the video or audio type of asset.
   /// 该字段用在选择器视频或音频部件上，用于显示视频或音频资源的时长。
   String durationIndicatorBuilder(Duration duration);
 }

lib/src/provider/asset_entity_image_provider.dart

@@ -80,7 +80,7 @@ class AssetEntityImageProvider extends ImageProvider<AssetEntityImageProvider> {
   /// 从图片后缀判断图片类型
   ///
   /// ⚠ Not all the system version support read file name from the entity,
-  /// so this method might not working sometime.
+  /// so this method might not work sometime.
   /// 并非所有的系统版本都支持读取文件名，所以该方法有时无法返回正确的type。
   ImageFileType _getType() {
     ImageFileType type;

lib/src/provider/asset_picker_provider.dart

@@ -69,7 +69,7 @@ class AssetPickerProvider extends ChangeNotifier {
     super.dispose();
   }
 
-  /// Whether there's any assets on the devices.
+  /// Whether there're any assets on the devices.
   /// 设备上是否有资源文件
   bool _isAssetsEmpty = false;
 
@@ -83,7 +83,7 @@ class AssetPickerProvider extends ChangeNotifier {
     notifyListeners();
   }
 
-  /// Whether there's any assets that can be displayed.
+  /// Whether there're any assets that can be displayed.
   /// 是否有资源可供显示
   bool _hasAssetsToDisplay = false;
 
@@ -98,11 +98,11 @@ class AssetPickerProvider extends ChangeNotifier {
     notifyListeners();
   }
 
-  /// Whether there's more assets waiting for load.
+  /// Whether there're more assets waiting for load.
   /// 是否还有更多资源可以加载
   bool get hasMoreToLoad => _currentAssets.length < _totalAssetsCount;
 
-  /// Current page for assets list.
+  /// The current page for assets list.
   /// 当前加载的资源列表分页数
   int get currentAssetsListPage =>
       (math.max(1, _currentAssets.length) / pageSize).ceil();
@@ -122,7 +122,7 @@ class AssetPickerProvider extends ChangeNotifier {
     notifyListeners();
   }
 
-  /// If path switcher was opened.
+  /// If path switcher opened.
   /// 是否正在进行路径选择
   bool _isSwitchingPath = false;
 
@@ -200,7 +200,7 @@ class AssetPickerProvider extends ChangeNotifier {
   Future<void> getAssetPathList() async {
     final List<AssetPathEntity> _list = await PhotoManager.getAssetPathList(
       type: requestType,
-      // Enable need title for audio and image to get proper display.
+      // Enable need title for audios and image to get proper display.
       filterOption: FilterOptionGroup()
         ..setOption(
           AssetType.audio,

lib/src/provider/asset_picker_viewer_provider.dart

@@ -14,7 +14,7 @@ class AssetPickerViewerProvider extends ChangeNotifier {
     _currentlySelectedAssets = List<AssetEntity>.from(assets);
   }
 
-  /// Selected assets in viewer.
+  /// Selected assets in the viewer.
   /// 查看器中已选择的资源
   List<AssetEntity> _currentlySelectedAssets;
 

lib/src/widget/asset_picker.dart

@@ -47,23 +47,23 @@ class AssetPicker extends StatelessWidget {
   /// 资源选择器状态保持
   final AssetPickerProvider provider;
 
-  /// Assets count for picker.
+  /// Assets count for the picker.
   /// 资源网格数
   final int gridCount;
 
-  /// Main color for picker.
+  /// Main color for the picker.
   /// 选择器的主题色
   final Color themeColor;
 
   /// Theme for the picker.
   /// 选择器的主题
   ///
-  /// Usually the WeChat uses the dark version (dark background color) for the picker,
-  /// but some developer wants a light theme version for some reasons.
+  /// Usually the WeChat uses the dark version (dark background color) for the picker.
+  /// However, some developer wants a light theme version for some reasons.
   /// 通常情况下微信选择器使用的是暗色（暗色背景）的主题，但某些情况下开发者需要亮色或自定义主题。
   final ThemeData pickerTheme;
 
-  /// Static method to push with navigator.
+  /// Static method to push with the navigator.
   /// 跳转至选择器的静态方法
   static Future<List<AssetEntity>> pickAssets(
     BuildContext context, {
@@ -142,7 +142,7 @@ class AssetPicker extends StatelessWidget {
     }
   }
 
-  /// Unregister observe callback with assets changes.
+  /// Unregister the observation callback with assets changes.
   /// 取消注册资源（图库）变化的监听回调
   static void unregisterObserve([ValueChanged<MethodCall> callback]) {
     try {
@@ -161,7 +161,7 @@ class AssetPicker extends StatelessWidget {
   /// 选择器是否为单选模式
   bool get isSingleAssetMode => provider.maxAssets == 1;
 
-  /// Space between asset item widget.
+  /// Space between assets item widget.
   /// 资源部件之间的间隔
   double get itemSpacing => 2.0;
 
@@ -227,7 +227,7 @@ class AssetPicker extends StatelessWidget {
         ),
       );
 
-  /// [ThemeData] for picker.
+  /// [ThemeData] for the picker.
   /// 选择器使用的主题
   ThemeData get theme => pickerTheme ?? themeData(themeColor);
 
@@ -296,7 +296,7 @@ class AssetPicker extends StatelessWidget {
         ),
       );
 
-  /// Item widget for path entity selector.
+  /// Item widgets for path entity selector.
   /// 路径单独条目选择组件
   Widget pathEntityWidget(AssetPathEntity pathEntity) {
     return Material(
@@ -498,7 +498,7 @@ class AssetPicker extends StatelessWidget {
   /// Confirm button.
   /// 确认按钮
   ///
-  /// It'll pop with [AssetPickerProvider.selectedAssets] when there're any assets were chosen.
+  /// It'll pop with [AssetPickerProvider.selectedAssets] when there're any assets chosen.
   /// 当有资源已选时，点击按钮将把已选资源通过路由返回。
   Widget confirmButton(BuildContext context) => Consumer<AssetPickerProvider>(
         builder: (BuildContext _, AssetPickerProvider provider, Widget __) {
@@ -754,7 +754,7 @@ class AssetPicker extends StatelessWidget {
     );
   }
 
-  /// Item widget when [AssetEntity.thumbData] load failed.
+  /// Item widgets when [AssetEntity.thumbData] load failed.
   /// 资源缩略数据加载失败时使用的部件
   Widget get _failedItem => Center(
         child: Text(
@@ -820,7 +820,7 @@ class AssetPicker extends StatelessWidget {
         ),
       );
 
-  /// Item builder for audio type of asset.
+  /// The item builder for audio type of asset.
   /// 音频资源的部件构建
   Widget audioItemBuilder(
     BuildContext context,
@@ -859,7 +859,7 @@ class AssetPicker extends StatelessWidget {
     );
   }
 
-  /// Item builder for image and video type of asset.
+  /// The item builder for images and video type of asset.
   /// 图片和视频资源的部件构建
   Widget imageAndVideoItemBuilder(
     BuildContext context,

lib/src/widget/asset_picker_viewer.dart

@@ -48,14 +48,14 @@ class AssetPickerViewer extends StatefulWidget {
   /// 资源选择器的状态保持
   final AssetPickerProvider selectorProvider;
 
-  /// Theme for viewer.
+  /// Theme for the viewer.
   /// 主题
   final ThemeData themeData;
 
   @override
   AssetPickerViewerState createState() => AssetPickerViewerState();
 
-  /// Static method to push with navigator.
+  /// Static method to push with the navigator.
   /// 跳转至选择预览的静态方法
   static Future<List<AssetEntity>> pushToViewer(
     BuildContext context, {
@@ -110,7 +110,7 @@ class AssetPickerViewerState extends State<AssetPickerViewer>
   /// [StreamController] for viewing page index update.
   /// 用于更新当前正在浏览的资源页码的流控制器
   ///
-  /// The main purpose is to narrow down build parts when page index is changing, prevent
+  /// The main purpose is narrow down build parts when page index is changing, prevent
   /// widely [setState] and causing other widgets rebuild.
   /// 使用 [StreamController] 的主要目的是缩小页码变化时构建组件的范围，
   /// 防止滥用 [setState] 导致其他部件重新构建。
@@ -145,11 +145,11 @@ class AssetPickerViewerState extends State<AssetPickerViewer>
   /// 当前正在预览的资源索引
   int currentIndex;
 
-  /// Whether detail widgets is displayed.
+  /// Whether detail widgets displayed.
   /// 详情部件是否显示
   bool isDisplayingDetail = true;
 
-  /// Getter for current asset.
+  /// Getter for the current asset.
   /// 当前资源的Getter
   AssetEntity get currentAsset => widget.assets.elementAt(currentIndex);
 
@@ -164,8 +164,8 @@ class AssetPickerViewerState extends State<AssetPickerViewer>
   @override
   void initState() {
     super.initState();
-    // TODO(Alex): Currently hide status bar will cause the viewport shaking. So commented out.
 
+    // TODO(Alex): Currently hide status bar will cause the viewport shaking. So commented out.
     /// Hide system status bar automatically on iOS.
     /// 在iOS设备上自动隐藏状态栏
 //    if (Platform.isIOS) {
@@ -327,7 +327,7 @@ class AssetPickerViewerState extends State<AssetPickerViewer>
   /// Confirm button.
   /// 确认按钮
   ///
-  /// It'll pop with [AssetPickerProvider.selectedAssets] when there're any assets were chosen.
+  /// It'll pop with [AssetPickerProvider.selectedAssets] when there're any assets chosen.
   /// The [PhotoSelector] will recognize and pop too.
   /// 当有资源已选时，点击按钮将把已选资源通过路由返回。
   /// 资源选择器将识别并一同返回。
@@ -375,7 +375,7 @@ class AssetPickerViewerState extends State<AssetPickerViewer>
         ),
       );
 
-  /// Thumb item widget in bottom detail.
+  /// Thumb item widgets in bottom detail.
   /// 底部信息栏单个资源缩略部件
   Widget _bottomDetailItem(BuildContext _, int index) {
     return Padding(
@@ -454,7 +454,7 @@ class AssetPickerViewerState extends State<AssetPickerViewer>
     );
   }
 
-  /// Preview item widget for audio.
+  /// Preview item widgets for audios.
   /// 音频的底部预览部件
   Widget _audioPreviewItem(AssetEntity asset) {
     return ColoredBox(
@@ -463,7 +463,7 @@ class AssetPickerViewerState extends State<AssetPickerViewer>
     );
   }
 
-  /// Preview item widget for image.
+  /// Preview item widgets for images.
   /// 音频的底部预览部件
   Widget _imagePreviewItem(AssetEntity asset) {
     return Positioned.fill(
@@ -479,7 +479,7 @@ class AssetPickerViewerState extends State<AssetPickerViewer>
     );
   }
 
-  /// Preview item widget for video.
+  /// Preview item widgets for video.
   /// 音频的底部预览部件
   Widget _videoPreviewItem(AssetEntity asset) {
     return Positioned.fill(
@@ -660,7 +660,7 @@ class AssetPickerViewerState extends State<AssetPickerViewer>
         ),
       );
 
-  /// Item widget when [AssetEntity.thumbData] load failed.
+  /// The item widget when [AssetEntity.thumbData] load failed.
   /// 资源缩略数据加载失败时使用的部件
   Widget get _failedItem => Center(
         child: Text(

lib/src/widget/builder/audio_page_builder.dart

@@ -34,7 +34,7 @@ class _AudioPageBuilderState extends State<AudioPageBuilder> {
   /// 创建一个[AssetsAudioPlayer]的实例
   final AssetsAudioPlayer audioPlayer = AssetsAudioPlayer();
 
-  /// Whether the audio is loaded.
+  /// Whether the audio loaded.
   /// 音频是否已经加载完成
   bool isLoaded = false;
 
@@ -67,8 +67,8 @@ class _AudioPageBuilderState extends State<AudioPageBuilder> {
     super.dispose();
   }
 
-  /// Using [audioPlayer] to load content url from asset.
-  /// 使用[audioPlayer]通过content地址加载资源
+  /// Using [audioPlayer] to load content url from the asset.
+  /// 使用 [audioPlayer] 通过content地址加载资源
   Future<void> openAudioFile() async {
     try {
       assetDuration = Duration(seconds: widget.asset.duration);

lib/src/widget/builder/video_page_builder.dart

@@ -24,7 +24,7 @@ class VideoPageBuilder extends StatefulWidget {
 }
 
 class _VideoPageBuilderState extends State<VideoPageBuilder> {
-  /// Controller for video player.
+  /// Controller for the video player.
   /// 视频播放的控制器
   VideoPlayerController _controller;
 
@@ -56,7 +56,7 @@ class _VideoPageBuilderState extends State<VideoPageBuilder> {
     super.dispose();
   }
 
-  /// Get media url from asset, then initialize the controller and add with listener.
+  /// Get media url from the asset, then initialize the controller and add with a listener.
   /// 从资源获取媒体url后初始化，并添加监听。
   Future<void> initializeVideoPlayerController() async {
     final String url = await widget.asset.getMediaUrl();
@@ -91,8 +91,8 @@ class _VideoPageBuilderState extends State<VideoPageBuilder> {
   /// Callback for the play button.
   /// 播放按钮的回调
   ///
-  /// Normally it only switch play state for the player. If the video reaches the end, then click
-  /// the button will make the video replay.
+  /// Normally it only switches play state for the player. If the video reaches the end,
+  /// then click the button will make the video replay.
   /// 一般来说按钮只切换播放暂停。当视频播放结束时，点击按钮将从头开始播放。
   Future<void> playButtonCallback() async {
     if (_controller.value != null) {