chore(examples/todos): fix analyzer warnings in Dart 2.19 (#492)

Author: felangel

examples/todos/packages/in_memory_todos_data_source/lib/src/in_memory_todos_data_source.dart

@@ -3,7 +3,7 @@ import 'package:uuid/uuid.dart';
 
 /// An in-memory implementation of the [TodosDataSource] interface.
 class InMemoryTodosDataSource implements TodosDataSource {
-  /// Map of ID -> Todo
+  /// Map of ID -> `Todo`
   final _cache = <String, Todo>{};
 
   @override

examples/todos/packages/todos_data_source/lib/src/models/todo.dart

@@ -4,8 +4,8 @@ import 'package:meta/meta.dart';
 
 part 'todo.g.dart';
 
-/// {@template todo}
-/// A single todo item.
+/// {@template `todo`}
+/// A single `todo` item.
 ///
 /// Contains a [title], [description] and [id], in addition to a [isCompleted]
 /// flag.
@@ -20,37 +20,37 @@ part 'todo.g.dart';
 @immutable
 @JsonSerializable()
 class Todo extends Equatable {
-  /// {@macro todo}
+  /// {@macro `todo`}
   Todo({
     this.id,
     required this.title,
     this.description = '',
     this.isCompleted = false,
   }) : assert(id == null || id.isNotEmpty, 'id cannot be empty');
 
-  /// The unique identifier of the todo.
+  /// The unique identifier of the `todo`.
   ///
   /// Cannot be empty.
   final String? id;
 
-  /// The title of the todo.
+  /// The title of the `todo`.
   ///
   /// Note that the title may be empty.
   final String title;
 
-  /// The description of the todo.
+  /// The description of the `todo`.
   ///
   /// Defaults to an empty string.
   final String description;
 
-  /// Whether the todo is completed.
+  /// Whether the `todo` is completed.
   ///
   /// Defaults to `false`.
   final bool isCompleted;
 
-  /// Returns a copy of this todo with the given values updated.
+  /// Returns a copy of this `todo` with the given values updated.
   ///
-  /// {@macro todo}
+  /// {@macro `todo`}
   Todo copyWith({
     String? id,
     String? title,

examples/todos/packages/todos_data_source/lib/src/todos_data_source.dart

@@ -7,19 +7,19 @@ import 'package:todos_data_source/todos_data_source.dart';
 /// * U - Update
 /// * D - Delete
 abstract class TodosDataSource {
-  /// Create and return the newly created todo.
+  /// Create and return the newly created `todo`.
   Future<Todo> create(Todo todo);
 
   /// Return all todos.
   Future<List<Todo>> readAll();
 
-  /// Return a todo with the provided [id] if one exists.
+  /// Return a `todo` with the provided [id] if one exists.
   Future<Todo?> read(String id);
 
-  /// Update the todo with the provided [id] to match [todo] and
-  /// return the updated todo.
+  /// Update the `todo` with the provided [id] to match [todo] and
+  /// return the updated `todo`.
   Future<Todo> update(String id, Todo todo);
 
-  /// Delete the todo with the provided [id] if one exists.
+  /// Delete the `todo` with the provided [id] if one exists.
   Future<void> delete(String id);
 }