feat: Doc Comments updated

lib/src/material_route_builder.dart

@@ -2,6 +2,7 @@ import 'package:flutter/material.dart';
 
 import 'route_builder.dart';
 
+/// Material implementation of the RouteBuilder.
 class MaterialRouteBuilder implements RouteBuilder {
   @override
   Route build(WidgetBuilder builder, RouteSettings settings) {

lib/src/route_builder.dart

@@ -1,5 +1,8 @@
 import 'package:flutter/widgets.dart';
 
+/// The RouteBuilder is used to create [Route]s.
 abstract class RouteBuilder {
+  /// This method returns a [Route] which lead to a screen that shows [Widget]
+  /// built by the [builder].
   Route build(WidgetBuilder builder, RouteSettings settings);
 }

lib/src/route_expression_builder.dart

@@ -1,7 +1,7 @@
 import 'exception/unbalanced_curly_braces_exception.dart';
 import 'exception/unexpected_char_exception.dart';
 
-/// Provides functionality for building route paths to expressions.
+/// Provides functionality for converting route paths to expressions.
 class RouteExpressionBuilder {
   final String _path;
 

lib/src/route_provider.dart

@@ -1,5 +1,7 @@
 import 'registered_route.dart';
 
+/// This interface describe a object that can provide routes.
 abstract class RouteProvider {
+  /// Returns the existing routes.
   List<RegisteredRoute> get routes;
 }

lib/src/route_resolver.dart

@@ -2,6 +2,9 @@ import 'package:catalyst_builder/catalyst_builder.dart';
 import 'package:explorator/explorator.dart';
 import 'package:flutter/widgets.dart';
 
+/// The RouteResolver is used to resolve [Route]s from [RouteSettings].
+/// All possible routes are provided by the [RouteProvider]s which are injected
+/// by the routeProvider tag.
 @Service()
 class RouteResolver {
   final List<RouteProvider> _providers;
@@ -48,6 +51,10 @@ class RouteResolver {
     return null;
   }
 
+  /// Creates a enhanced service provider which contains additional services:
+  /// [RouteArguments] The arguments for the route which was resolved.
+  ///                  This contains query parameters and path variables
+  /// [RouteSettings]  The [RouteSettings] for the resolved route.
   ServiceProvider _createSubProvider(
     Map<String, String> pathVariables,
     Map<String, String> queryParameters,