impl react credits template README feedback

Author: marshacb

create-leo-app/template-react-credits-aleo-functions-ts/README.md

@@ -1,24 +1,24 @@
 # React Credits.aleo Functions Template
 
-This template demonstrates building execution transactions for all 6 credits.aleo
-transfer and record manipulation functions in a React application.
+This template demonstrates building execution transactions for 6 credits.aleo
+functions that demonstrate value transfers and record manipulation functions in a React application.
 
 ## Functions Demonstrated
 
 ### Public Transfers
 
-- **transfer_public**: Transfer credits between public balances
-- **transfer_public_to_private**: Convert public credits to a private record
+- **transfer_public**: Transfer credits between public balances.
+- **transfer_public_to_private**: Convert public credits to a private record.
 
 ### Private Transfers
 
-- **transfer_private**: Transfer credits using private records
-- **transfer_private_to_public**: Convert private record to public balance
+- **transfer_private**: Transfer credits using private records.
+- **transfer_private_to_public**: Convert private record to public balance.
 
 ### Record Operations
 
-- **join**: Combine two credit records into one
-- **split**: Split one credit record into two
+- **join**: Combine two credit records into one.
+- **split**: Split one credit record into two.
 
 ## Getting Started
 
@@ -36,38 +36,37 @@ Your app should be running on http://localhost:5173/
 This template uses `buildExecutionTransaction` to create real transactions that
 could be broadcast to the Aleo network. The SDK:
 
-1. Generates zero-knowledge proofs locally in your browser
-2. Fetches inclusion proofs from the network for private record operations
-3. Builds complete transactions ready for broadcast
+1. Generates zero-knowledge proofs locally in your browser.
+2. Builds transactions from the proof ready for broadcast.
 
 **Note:** Transactions are built but not broadcast, so sample records remain
 unspent and can be reused.
 
 ### Credits Records
 
-Private credits in Aleo are stored as records with this structure:
+Private credits in the credits.aleo program (the official representation of value on the Aleo Network) are stored as Aleo records with this structure:
 
 ```
 {
-  owner: aleo1xxx...xxx.private,
-  microcredits: 1000000u64.private,
-  _nonce: 123...789group.public,
-  _version: 1u8.public
+  owner: aleo1xxx...xxx.private, // An aleo address that owns the record.
+  microcredits: 1000000u64.private, // The amount in microcredits contained in the record.
+  _nonce: 123...789group.public, // The unique nonce identifying the record.
+  _version: 1u8.public // The version of the record.
 }
 ```
 
 ### Microcredits
 
 1 Aleo credit = 1,000,000 microcredits. All amounts are specified in
-microcredits with the `u64` suffix (e.g., `50000u64`).
+microcredits as plain numbers (e.g., `50000`).
 
 ## Notes
 
-- Network connectivity is required for inclusion proofs
-- Public function execution takes ~10-15 seconds
-- Private function execution takes ~30-120 seconds (includes network calls)
-- Sample records are pre-filled for testing
-- First execution downloads proving keys (~40-100MB)
+- Network connectivity is required for this app.
+- Public function execution takes ~10-15 seconds.
+- Private function execution takes ~30-120 seconds (depending on whether keys are locally cached or not).
+- Sample records are pre-filled for testing.
+- First execution downloads proving keys (~40-100MB).
 
 ## Production Build