added nitpick changes

Author: akshatnema

development/scripts/build-docs.md

@@ -18,7 +18,7 @@ The `build-docs.ts` script is responsible for generating and managing the docume
 
 ## Workflow
 
-1. Build hierarchical navigation tree from flat items using `buildNavTree()`
+1. Build a hierarchical navigation tree from flat items using `buildNavTree()`
     - Sort items by section type and weight
     - Create root sections, subsections, and document pages
     - Handle special cases like specification references
@@ -60,20 +60,31 @@ Simple structure containing navigation link information:
 - `href`: URL link
 
 ## Special Features
-- Special handling for the welcome page at /docs
+- Special handling for the welcome page at `/docs`
 - Reference/specification section with automatic linking to latest specification version
 - Weight-based sorting for proper ordering of sections and documents
 - Root sections and subsections are marked differently than content pages
 - Handles navigation between document sections with smart previous/next links
 - Error handling with detailed error messages
 
-## Command
-
-To run the script manually, execute:
-
-```bash
-tsx scripts/build-docs.ts
-```
+## Development Setup
+1. **Prerequisites**:
+   - Node.js and npm installed
+   - TypeScript installed globally or as a dev dependency
+    - Access to the project repository
+2. **Installing Dependencies**:
+    ```bash
+    npm install
+    ```
+3. **Running the Script**:
+    - Ensure the environment variables are set.
+    - Execute the script using:
+      ```bash
+      tsx scripts/build-docs.ts
+      ```
+4. **Output**:
+    - The output will be a JSON file containing the hierarchical navigation structure and an array of document pages with their respective navigation controls.
+    - The file will be saved in the specified path (e.g., `../config/posts.json`).
 
 ## Output
 The output will be a JSON file containing the hierarchical navigation structure and an array of document pages with their respective navigation controls. The file will be saved in the specified path (e.g., `../config/posts.json`).
@@ -84,9 +95,9 @@ No environment variables are required for this script.
 
 ## Usage Context
 
-This script appears to be part of a documentation website generation pipeline. It's designed to:
+This script is part of a documentation website generation pipeline. It's designed to:
 
 1. Parse raw documentation items
-2. Create a organized navigation structure
+2. Create an organized navigation structure
 3. Add user-friendly navigation controls
 4. Support hierarchical documentation with sections and subsections

development/scripts/build-meetings.md

@@ -56,7 +56,7 @@ This script is a Node.js module that interacts with the Google Calendar API to f
 
 4. **Installing Dependencies**:
   ```bash
-   npm install
+  npm install
   ```
 
 5. **Running the Script**:

development/scripts/build-newsroom-videos.md

@@ -79,7 +79,7 @@ This script is a Node.js module that interacts with the YouTube Data API to fetc
 
 - **Execution**:
   - When run directly, the script writes to `../config/newsroom_videos.json`.
-  - Can be imported and used as a module with a custom write path.
+  - It can be imported and used as a module with a custom write path.
 
 ### Example Command
 

development/scripts/build-pages.md

@@ -51,7 +51,7 @@ This TypeScript script transforms markdown files into MDX files suitable for a R
 
 #### `ensureDirectoryExists(directory: PathLike)`
 - Checks if a directory exists and creates it if it doesn't
-- Used to ensure the target directory exists before processing
+- Ensures that the target directory exists before processing
 
 #### `capitalizeJsxTags(content: string): string`
 - Transforms HTML tags to capitalized JSX component tags

development/scripts/build-tools.md

@@ -1,4 +1,4 @@
-## Tools Build Script Documentation
+## Build Tools Script Documentation
 
 ### Overview
 
@@ -59,7 +59,7 @@ The script generates the following files in the `config` directory:
 
 4. **Environment Configuration**
   - Create a `.env` file in the project root with the following variables:
-    ```
+    ```bash
     GITHUB_TOKEN='{your-github-token}'
     ```
   - Alternatively, set these variables in your shell environment.