From 94d1fc805d970142b7277c51477821f9bd0545f5 Mon Sep 17 00:00:00 2001
From: Documentation Bot <docs@juspay.in>
Date: Thu, 26 Mar 2026 23:50:25 +0530
Subject: [PATCH] docs(prism): reformat markdown files
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add YAML frontmatter with descriptions
- Fix heading hierarchies (H1→H2→H3)
- Fix formatting: lists, tables, spacing
- Apply Juspay Hyperswitch brand rules
- Update canonical product stats
- Fix typos and inconsistencies
---
 prism/README.md                                     |  4 ++++
 prism/api-reference/README.md                       |  4 ++++
 prism/api-reference/domain-schema/README.md         | 13 ++++---------
 prism/architecture/README.md                        |  4 ++++
 ...e-built-a-unified-payment-integration-library.md |  4 ++++
 prism/connectors/adyen.md                           |  4 ++++
 prism/connectors/paypal.md                          |  4 ++++
 prism/connectors/stripe.md                          |  4 ++++
 prism/connectors/zift.md                            |  4 ++++
 prism/getting-started/create-order.md               |  4 ++++
 prism/getting-started/extend-to-more-flows.md       |  4 ++++
 prism/getting-started/first-payment.md              |  4 ++++
 prism/getting-started/installation.md               |  4 ++++
 13 files changed, 52 insertions(+), 9 deletions(-)

diff --git a/prism/README.md b/prism/README.md
index d11f1cdf..fe769843 100644
--- a/prism/README.md
+++ b/prism/README.md
@@ -1,3 +1,7 @@
+---
+description: High-performance payment abstraction library for 100+ connectors with multi-language SDK support
+---
+
 <div align="center">
 
 
diff --git a/prism/api-reference/README.md b/prism/api-reference/README.md
index 8da04ed7..9c116370 100644
--- a/prism/api-reference/README.md
+++ b/prism/api-reference/README.md
@@ -1,3 +1,7 @@
+---
+description: Complete reference for Prism gRPC API services including payment, refund, recurring, and dispute operations
+---
+
 # API Reference
 
 Complete reference for all Prism API services, request/response types, and error handling.
diff --git a/prism/api-reference/domain-schema/README.md b/prism/api-reference/domain-schema/README.md
index bf22e262..15708498 100644
--- a/prism/api-reference/domain-schema/README.md
+++ b/prism/api-reference/domain-schema/README.md
@@ -1,13 +1,8 @@
-# Domain Schema
-
-<!--
 ---
-title: Domain Schema
-description: Complete reference for all domain types, enums, and data structures used across Connector Service services
-last_updated: 2026-03-11
-generated_from: crates/types-traits/grpc-api-types/proto/
-auto_generated: false
-reviewed_by: engineering
+description: Complete reference for all domain types, enums, and data structures used across Connector Service
+---
+
+# Domain Schema
 reviewed_at: 2026-03-05
 approved: true
 ---
diff --git a/prism/architecture/README.md b/prism/architecture/README.md
index 3f5d084d..7a3fb0ca 100644
--- a/prism/architecture/README.md
+++ b/prism/architecture/README.md
@@ -1,3 +1,7 @@
+---
+description: Understand the Prism architecture with interface, binding, and core layers for unified payment processing
+---
+
 ## Architecture Overview
 
 If you've integrated multiple payment providers, you know the pain:
diff --git a/prism/blogs/why-we-built-a-unified-payment-integration-library.md b/prism/blogs/why-we-built-a-unified-payment-integration-library.md
index c9c9dd46..ef8c8b40 100644
--- a/prism/blogs/why-we-built-a-unified-payment-integration-library.md
+++ b/prism/blogs/why-we-built-a-unified-payment-integration-library.md
@@ -1,3 +1,7 @@
+---
+description: Learn why Juspay built Prism, a unified payment integration library to solve multi-processor complexity
+---
+
 # Why we built a Unified Payment Integration Library?
 
 If you have ever integrated a payment processor, you know the drill. You read through a PDF that was last updated in 2019, figure out what combination of API keys goes in which header, discover that "decline code 51" means something subtly different on this processor than the last one you dealt with, and then do it all over again when your business decides to add a second processor.
diff --git a/prism/connectors/adyen.md b/prism/connectors/adyen.md
index 6baf811f..9cba1b02 100644
--- a/prism/connectors/adyen.md
+++ b/prism/connectors/adyen.md
@@ -1,3 +1,7 @@
+---
+description: Configure Adyen connector for payments, wallets, bank transfers, and recurring operations
+---
+
 # Adyen
 
 <!--
diff --git a/prism/connectors/paypal.md b/prism/connectors/paypal.md
index c9abf214..0c9424cf 100644
--- a/prism/connectors/paypal.md
+++ b/prism/connectors/paypal.md
@@ -1,3 +1,7 @@
+---
+description: Integrate PayPal payments with authorize, capture, refund, and wallet payment flows
+---
+
 # Paypal
 
 <!--
diff --git a/prism/connectors/stripe.md b/prism/connectors/stripe.md
index ba6a2214..8f42e985 100644
--- a/prism/connectors/stripe.md
+++ b/prism/connectors/stripe.md
@@ -1,3 +1,7 @@
+---
+description: Integrate Stripe payments with card, wallet, bank transfers, recurring payments, and tokenization support
+---
+
 # Stripe
 
 <!--
diff --git a/prism/connectors/zift.md b/prism/connectors/zift.md
index 6ac989f1..86f3da3a 100644
--- a/prism/connectors/zift.md
+++ b/prism/connectors/zift.md
@@ -1,3 +1,7 @@
+---
+description: Configure Zift connector and integrate payment flows including authorize, capture, refund, and void operations
+---
+
 # Zift
 
 <!--
diff --git a/prism/getting-started/create-order.md b/prism/getting-started/create-order.md
index 14b3ef14..64176fee 100644
--- a/prism/getting-started/create-order.md
+++ b/prism/getting-started/create-order.md
@@ -1,3 +1,7 @@
+---
+description: Create your first payment order and obtain session tokens for Stripe and Adyen integrations
+---
+
 # Quick Start
 
 Now that the library is installed and configured, let's create your first payment order (different payment processor's use different terminology - order, intent, transaction and so on). Conceptually, it represents the user's intent to start a payment session. 
diff --git a/prism/getting-started/extend-to-more-flows.md b/prism/getting-started/extend-to-more-flows.md
index 5936cb4c..3e31ae5f 100644
--- a/prism/getting-started/extend-to-more-flows.md
+++ b/prism/getting-started/extend-to-more-flows.md
@@ -1,3 +1,7 @@
+---
+description: Implement advanced payment flows including recurring payments, incremental authorization, partial capture, and webhooks
+---
+
 # Extending to More Flows
 
 You have implemented the basic plumbing for routing payment processor agnostic APIs. All methods work the same way with the single interface regardless of which payment processor you use. That's the power you get with the library.
diff --git a/prism/getting-started/first-payment.md b/prism/getting-started/first-payment.md
index 34503351..f13cb849 100644
--- a/prism/getting-started/first-payment.md
+++ b/prism/getting-started/first-payment.md
@@ -1,3 +1,7 @@
+---
+description: Process your first payment using the Prism library with authorization, capture, and refund flows
+---
+
 # First Payment
 
 In the next few steps you will authorize the payment, handle errors, capture funds, and process refunds. And then you will be ready to send payment to any payment processor, without writing specialized code for each.
diff --git a/prism/getting-started/installation.md b/prism/getting-started/installation.md
index 16e7bc2c..be83f252 100644
--- a/prism/getting-started/installation.md
+++ b/prism/getting-started/installation.md
@@ -1,3 +1,7 @@
+---
+description: Install and configure the Hyperswitch Prism library for Node.js, Python, Java, and PHP
+---
+
 # Installation and Configuration