wip

Author: tymondesigns

docs/json-schema/installation.mdx

@@ -13,15 +13,9 @@ icon: 'terminal'
 
 <Steps>
 <Step title="Install via Composer">
-  Install the package using Composer with one of these commands:
-
   ```bash
     composer require cortexphp/json-schema
   ```
-
-  <Check>
-  Verify the package was installed by running: `composer show cortexphp/json-schema`
-  </Check>
 </Step>
 
 <Step title="Set Default Version (Optional)">
@@ -72,11 +66,3 @@ If you're contributing to the package or want to run tests:
 ## Next Steps
 
 Now that you have the package installed, you're ready to create your first JSON Schema:
-
-<Card
-  title="Quick Start Guide"
-  icon="bolt"
-  href="/quickstart"
->
-  Learn how to create and validate schemas with practical examples
-</Card>

docs/json-schema/introduction.mdx

@@ -180,22 +180,3 @@ The package defaults to Draft 2020-12 for the latest features. Use Draft-07 for
 | `unevaluatedProperties` | ❌ | ✅ | ✅ |
 | `dependentSchemas` | ❌ | ✅ | ✅ |
 | `prefixItems` | ❌ | ❌ | ✅ |
-
-## Next Steps
-
-<CardGroup cols={2}>
-  <Card
-    title="Get Started"
-    icon="rocket"
-    href="/json-schema/installation"
-  >
-    Install the package and create your first schema
-  </Card>
-  <Card
-    title="Quick Start Guide"
-    icon="bolt"
-    href="/json-schema/quickstart"
-  >
-    Learn the basics with practical examples
-  </Card>
-</CardGroup>

docs/json-schema/mcp-server.mdx

@@ -277,22 +277,3 @@ The MCP server provides access to comprehensive documentation, code examples, an
 </Accordion>
 </AccordionGroup>
 
-## Additional Resources
-
-<CardGroup cols={2}>
-  <Card
-    title="CortexPHP Documentation"
-    icon="book"
-    href="https://docs.cortexphp.com"
-  >
-    Browse the complete CortexPHP documentation
-  </Card>
-  <Card
-    title="MCP Protocol"
-    icon="link"
-    href="https://modelcontextprotocol.io"
-  >
-    Learn more about the Model Context Protocol
-  </Card>
-</CardGroup>
-

docs/json-schema/quickstart.mdx

@@ -172,9 +172,9 @@ Use `toArray()` when you need to programmatically work with the schema structure
   $usernameSchema->isValid('john-doe');    // false (contains hyphen)
   ```
 
-  <Check>
+  <Tip>
   String schemas support patterns, length constraints, and format validation.
-  </Check>
+  </Tip>
 </Tab>
 
 <Tab title="Array Validation">
@@ -193,9 +193,9 @@ Use `toArray()` when you need to programmatically work with the schema structure
   $tagsSchema->isValid([]);                        // false (too few items)
   ```
 
-  <Check>
+  <Tip>
   Array schemas can validate item types, count limits, and uniqueness.
-  </Check>
+  </Tip>
 </Tab>
 
 <Tab title="Nested Objects">
@@ -215,9 +215,9 @@ Use `toArray()` when you need to programmatically work with the schema structure
       );
   ```
 
-  <Check>
+  <Tip>
   Object schemas support unlimited nesting and property requirements.
-  </Check>
+  </Tip>
 </Tab>
 </Tabs>
 
@@ -227,7 +227,7 @@ You can also use schema classes directly instead of the factory:
 
 <CodeGroup>
 
-```php Factory Method (Recommended)
+```php Factory Method
 use Cortex\JsonSchema\Schema;
 
 $schema = Schema::string('name')
@@ -362,7 +362,3 @@ Schema::setDefaultVersion(SchemaVersion::Draft_07); // For maximum compatibility
     Master data validation and error handling techniques
   </Card>
 </CardGroup>
-
-<Tip>
-The Schema class provides the most convenient way to create schemas. All examples in this documentation use the factory methods unless otherwise specified.
-</Tip>

docs/json-schema/schema-types/array.mdx

@@ -535,22 +535,3 @@ try {
     Validate complex nested structures like menu trees or organizational hierarchies.
   </Card>
 </CardGroup>
-
-## Next Steps
-
-<CardGroup cols={2}>
-  <Card
-    title="Object Schema"
-    icon="cube"
-    href="/schema-types/object"
-  >
-    Learn about validating complex object structures
-  </Card>
-  <Card
-    title="Advanced Array Features"
-    icon="star"
-    href="/advanced/unevaluated-properties"
-  >
-    Explore advanced array validation features in modern JSON Schema versions
-  </Card>
-</CardGroup>

docs/json-schema/schema-types/object.mdx

@@ -519,6 +519,12 @@ $schema->isValid([
 ## Common Use Cases
 
 <CardGroup cols={2}>
+  <Card title="AI Structured Output" icon="sparkles">
+    Define schemas for LLM responses to ensure consistent, parseable structured data from AI models.
+  </Card>
+  <Card title="AI Tool Calling" icon="wrench">
+    Specify function parameters for AI agents and assistants to enable reliable tool invocation.
+  </Card>
   <Card title="API Request/Response" icon="api">
     Validate JSON API payloads with structured data and specific field requirements.
   </Card>
@@ -532,22 +538,3 @@ $schema->isValid([
     Validate data models before persistence with property and constraint validation.
   </Card>
 </CardGroup>
-
-## Next Steps
-
-<CardGroup cols={2}>
-  <Card
-    title="Array Schema"
-    icon="list"
-    href="/schema-types/array"
-  >
-    Learn about array validation and nested data structures
-  </Card>
-  <Card
-    title="Advanced Object Features"
-    icon="star"
-    href="/advanced/pattern-properties"
-  >
-    Explore pattern properties and advanced object validation
-  </Card>
-</CardGroup>