Improve docs of FilterDispatcher

src/dispatching/dispatchers/filter.rs

@@ -16,14 +16,19 @@ type FiltersWithHandlers<'a, T, E> = Vec<FilterWithHandler<'a, T, E>>;
 
 /// A dispatcher based on filters.
 ///
-/// This is 'filter' implementation with following limitations:
+/// Filters and handlers are executed in order of registering. The pseudocode
-/// - Error (`E` generic parameter) _must_ implement [`std::fmt::Debug`]
+/// looks like this:
-/// - All 'handlers' are boxed
+///
-/// - Handler's fututres are also boxed
+/// ```
-/// - All handlers executed in order (this means that in dispatching have 2
+/// for pair in handlers_and_filters {
-///   upadtes it will first execute some handler into complition with first
+///     if pair.filter.test(update) {
-///   update and **then** search for handler for second update, this is probably
+///         pair.handle(update);
-///   wrong)
+///         return;
+///     }
+/// }
+///
+/// log("unhandeled update: " + update);
+/// ```
 ///
 /// ## Examples
 ///