chore: Add Routing and RouterLink docs (#11456)

* chore: Add Routing and RouterLink docs

* example

docs/README.md

@@ -36,6 +36,7 @@
 - [Test on a real device: create a beta](deploy_to_beta.md)
 - [Generate a Release build for local testing](generate_a_release_build_for_local_testing.md)
 - [Pull Request template](pull_request_template.md)
+- [Routing](routing.md)
 - [Introduction to animations in Eigen](intro_animations_in_eigen)
 
 ### Beta

docs/routing.md

@@ -0,0 +1,19 @@
+# Routing
+
+All app routes are specified in [routes.tsx].
+
+## RouterLink Component
+
+The [RouterLink] component wraps `Touchable` and enables navigation to a specific route when pressed. It also supports prefetching the route as it comes into view.
+
+```typescript
+<RouterLink to="/my-route" navigationProps={{ filters: ["my-filter"]}} onPress={onPress}>
+  {children}
+</RouterLink>
+```
+
+Alternatively, [navigate] can be used to programmatically navigate to a given route.
+
+[routes.tsx]: /src/app/Navigation/routes.tsx
+[RouterLink]: /src/app/system/navigation/RouterLink.tsx
+[navigate]: /src/app/system/navigation/navigate.ts

src/app/system/navigation/RouterLink.tsx

@@ -11,6 +11,10 @@ interface RouterLinkProps {
   to?: string | null | undefined
 }
 
+/**
+ * Wrapper component around <Touchable> that navigates to a specified route (the `to` prop) when pressed.
+ * `RouterLink` also supports prefetching the route when it comes into view.
+ */
 export const RouterLink: React.FC<RouterLinkProps & TouchableProps> = ({
   disablePrefetch,
   to,