Skip to content

Commit e6a307f

Browse files
committed
enhanced Feature Based Route Management docs
1 parent f8d0315 commit e6a307f

File tree

1 file changed

+37
-11
lines changed

1 file changed

+37
-11
lines changed

src/util/feature-u/docs/feature-u.md

Lines changed: 37 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -501,23 +501,49 @@ Under the covers, `runApp()` is managing the following details:
501501
## Feature Based Route Management
502502

503503
You may be surprised to discover that feature-u introduces it's own
504-
flavor of route management. There are so many router implementations!
504+
flavor of route management. There are so many router implementations!
505505
Why introduce yet another?
506506

507+
**Don't Worry, Be Happy**
508+
509+
Actually, the feature-u router is a **completely optional aspect**, so
510+
don't be alarmed if you have already settled on your own
511+
route/navigation solution.
512+
513+
You are free to use whatever route/navigation solution that meets your
514+
requirements.
515+
- You can use the built-in feature-u routes
516+
- You can use XYZ navigation (_fill in the blank with your chosen solution_)
517+
- You can even use a combination of feature-u routes and XYZ routes
518+
519+
The only caveat in using another route managements system is that the
520+
XYZ routes will not be an integral part of feature-u, so your feature
521+
encapsulation may be somewhat compromised. This may or may not be a
522+
concern. With that said, it is theoretically possible to introduce
523+
your own feature-u extension supporting XYZ routes, which would bring
524+
it back into the realm of "the extended" feature-u. For now, this
525+
exercise is left up to you, as there are so many route management
526+
solutions.
527+
528+
**feature-u routes**
529+
530+
The **big benefit of the feature-u router** (_should you choose to use it_)
531+
is **it allows a feature to promote it's screens in an encapsulated and
532+
autonomous way**!
507533
The feature-u router is _based on a very simple concept_: **allow the
508534
application state to drive the routes!**
509535

510536
In feature based routing, you will not find the typical "route path to
511-
component" mapping catalog, where a `route('signIn')` directive causes
512-
the SignIn screen to display, which in turn causes the system to
513-
accommodate the request by adjusting it's state appropriately.
514-
Rather, the appState is analyzed, and if the user is NOT
515-
authenticated, the SignnIn screen is automatically displayed ... Easy
516-
Peasy!
517-
518-
Not only is this approach **more natural** (_imho_), but _more
519-
importantly_, **it allows a feature to promote it's screens in an
520-
encapsulated and autonomous way**.
537+
component" mapping catalog, where (_for example_) some pseudo
538+
`route('signIn')` directive causes the SignIn screen to display, which
539+
in turn causes the system to accommodate the request by adjusting it's
540+
state appropriately. Rather, the appState is analyzed, and if the
541+
user is NOT authenticated, the SignIn screen is automatically
542+
displayed ... Easy Peasy!
543+
544+
Depending on your perspective, this approach can be **more natural**,
545+
but _more importantly_, **it allows features to promote their own
546+
screens in an encapsulated and autonomous way**!
521547

522548
**Here is how it works:**
523549

0 commit comments

Comments
 (0)