docs: categorization (#276)

* docs: rename categories to be more descriptive

* fix(docs): invalid typing in Swift docs

* fix(docs): broken links

Author: artus9033

docs/docs/docs/api-reference/_meta.json

@@ -2,16 +2,16 @@
   {
     "type": "dir",
     "name": "react-native-brownfield",
-    "label": "ReactNativeBrownfield"
+    "label": "iOS & Android integration"
   },
   {
     "type": "dir",
-    "name": "brownfield-navigation.mdx",
-    "label": "BrownfieldNavigation"
+    "name": "brownfield-navigation",
+    "label": "Navigation"
   },
   {
     "type": "dir",
     "name": "brownie",
-    "label": "Brownie"
+    "label": "State Management"
   }
 ]

…nce/brownfield-navigation.mdx/_meta.json …ference/brownfield-navigation/_meta.jsondocs/docs/docs/api-reference/brownfield-navigation.mdx/_meta.json renamed to docs/docs/docs/api-reference/brownfield-navigation/_meta.json docs/docs/docs/api-reference/brownfield-navigation.mdx/_meta.json renamed to docs/docs/docs/api-reference/brownfield-navigation/_meta.json

@@ -13,9 +13,9 @@ You define a TypeScript contract once, generate native bridge files, and impleme
 
 ## Guides
 
-- [Setup and Codegen](/docs/api-reference/brownfield-navigation.mdx/setup-and-codegen)
-- [Native Integration](/docs/api-reference/brownfield-navigation.mdx/native-integration)
-- [JavaScript Usage](/docs/api-reference/brownfield-navigation.mdx/javascript-usage)
+- [Setup and Codegen](/docs/api-reference/brownfield-navigation/setup-and-codegen)
+- [Native Integration](/docs/api-reference/brownfield-navigation/native-integration)
+- [JavaScript Usage](/docs/api-reference/brownfield-navigation/javascript-usage)
 
 ## Example Projects
 

…navigation.mdx/brownfield-navigation.mdx …eld-navigation/brownfield-navigation.mdxdocs/docs/docs/api-reference/brownfield-navigation.mdx/brownfield-navigation.mdx renamed to docs/docs/docs/api-reference/brownfield-navigation/brownfield-navigation.mdx docs/docs/docs/api-reference/brownfield-navigation.mdx/brownfield-navigation.mdx renamed to docs/docs/docs/api-reference/brownfield-navigation/brownfield-navigation.mdx

@@ -39,9 +39,11 @@ export interface BrownfieldNavigationSpec {
 
 :::info
 Prefer simple synchronous navigation methods (`void`).
-<br/>
-Async Promise-based methods are not currently supported by the generated native code on iOS and Android — they will compile, but the generated implementations will reject with a `not_implemented` error.
-:::
+
+<br />
+Async Promise-based methods are not currently supported by the generated native
+code on iOS and Android — they will compile, but the generated implementations
+will reject with a `not_implemented` error. :::
 
 ## 2) Run codegen
 
@@ -74,5 +76,5 @@ Then recompile native apps.
 
 ## Next
 
-- Continue with [Native Integration](/docs/api-reference/brownfield-navigation.mdx/native-integration)
-- Then wire JS calls from [JavaScript Usage](/docs/api-reference/brownfield-navigation.mdx/javascript-usage)
+- Continue with [Native Integration](/docs/api-reference/brownfield-navigation/native-integration)
+- Then wire JS calls from [JavaScript Usage](/docs/api-reference/brownfield-navigation/javascript-usage)

…ield-navigation.mdx/javascript-usage.mdx …ownfield-navigation/javascript-usage.mdxdocs/docs/docs/api-reference/brownfield-navigation.mdx/javascript-usage.mdx renamed to docs/docs/docs/api-reference/brownfield-navigation/javascript-usage.mdx docs/docs/docs/api-reference/brownfield-navigation.mdx/javascript-usage.mdx renamed to docs/docs/docs/api-reference/brownfield-navigation/javascript-usage.mdx

@@ -30,7 +30,7 @@ ReactNativeBrownfield.shared
 
 | Property            | Type            | Default         | Description                                                                                    |
 | ------------------- | --------------- | --------------- | ---------------------------------------------------------------------------------------------- |
-| `entryFile`         | `NSString`      | `index`         | Path to JavaScript entry file in development.                                                  |
+| `entryFile`         | `String`        | `index`         | Path to JavaScript entry file in development.                                                  |
 | `bundlePath`        | `String`        | `main.jsbundle` | Path to JavaScript bundle file.                                                                |
 | `bundle`            | `Bundle`        | `Bundle.main`   | Bundle instance to lookup the JavaScript bundle resource.                                      |
 | `bundleURLOverride` | `(() -> URL?)?` | `nil`           | Dynamic bundle URL provider called on every bundle load. When set, overrides default behavior. |

…ld-navigation.mdx/native-integration.mdx …nfield-navigation/native-integration.mdxdocs/docs/docs/api-reference/brownfield-navigation.mdx/native-integration.mdx renamed to docs/docs/docs/api-reference/brownfield-navigation/native-integration.mdx docs/docs/docs/api-reference/brownfield-navigation.mdx/native-integration.mdx renamed to docs/docs/docs/api-reference/brownfield-navigation/native-integration.mdx

@@ -10,5 +10,5 @@ Technically, the CLI itself is encapsulated in the `@callstack/brownfield-cli` p
 
 Please refer to the appropriate pages for detailed usage instructions for each of the ecosystem packages:
 
-- [`@callstack/react-native-brownfield` - Brownfield library commands](./brownfield)
-- [`@callstack/brownie` - Brownie state management library commands](./brownie)
+- [iOS & Android integration](./brownfield) — `@callstack/react-native-brownfield` commands
+- [State Management](./brownie) — `@callstack/brownie` commands