diff --git a/lib/src/core/controller.dart b/lib/src/core/controller.dart
index b9dd28dc..36573f4c 100644
--- a/lib/src/core/controller.dart
+++ b/lib/src/core/controller.dart
@@ -124,7 +124,15 @@ class Controller {
     };
   }
 
-  /// Used to add additional routes to the router from within a [Controller].
+  /// Used to add additional routes or middlewares to the router from within
+  /// a [Controller].
+  ///
+  /// ```dart
+  /// @override
+  /// FutureOr<void> configureRoutes(Routable routable) {
+  ///   routable.all('*', myMiddleware);
+  /// }
+  /// ```
   FutureOr<void> configureRoutes(Routable routable) {}
 
   /// Finds the [Expose] declaration for this class.
diff --git a/lib/src/core/metadata.dart b/lib/src/core/metadata.dart
index 877073ff..b0d245a2 100644
--- a/lib/src/core/metadata.dart
+++ b/lib/src/core/metadata.dart
@@ -21,7 +21,20 @@ class Hooks {
   const Hooks({this.before = const [], this.after = const []});
 }
 
-/// Exposes a [Controller] to the Internet.
+/// Exposes a [Controller] or a [Controller] method to the Internet.
+///
+/// ```dart
+/// @Expose('/elements')
+/// class ElementController extends Controller {
+///
+///   @Expose('')
+///   getList(){}
+///
+///   @Expose('/:elementId')
+///   getElement(int elementId){}
+///
+/// }
+/// ```
 class Expose {
   final String method;
   final String path;