Update post creation scripts to include descriptive title in directory structure

Author: mrbiggred

AGENTS.md

@@ -134,16 +134,18 @@ Two helper scripts are available for creating new blog posts:
 
 1. **Bash Script** (`create_post.sh`):
    - Calculates next Tuesday from current date
-   - Creates directory structure: `docs/posts/YYYY/MM/DD/`
+   - Creates directory structure: `docs/posts/YYYY/MM/DD/YYYY-MM-DD-title-of-post/`
    - Generates `index.md` with proper frontmatter template
    - Usage: `./create_post.sh`
+   - **Note**: Rename the created folder with a descriptive title after running
 
 2. **PowerShell Script** (`create_post.ps1`):
    - Same functionality as bash script
    - For Windows users
    - Usage: `.\create_post.ps1`
+   - **Note**: Rename the created folder with a descriptive title after running
 
-Both scripts automatically determine the date of the next Tuesday (or current day if Tuesday) and create the appropriate directory structure.
+Both scripts automatically determine the date of the next Tuesday (or current day if Tuesday) and create the appropriate directory structure with a placeholder title. After running, rename the folder to include a descriptive title (e.g., `2026-01-13-ai-coding-assistants`).
 
 ## Development Workflows
 

README.md

@@ -74,12 +74,16 @@ We provide scripts to automatically create properly formatted blog posts for the
 
 These scripts will:
 - Calculate the date of the next Tuesday (or use today if it's Tuesday)
-- Create the directory structure: `docs/posts/YYYY/MM/DD/`
+- Create the directory structure: `docs/posts/YYYY/MM/DD/YYYY-MM-DD-title-of-post/`
 - Generate an `index.md` file with proper frontmatter
 
+**Note**: After running the script, rename the created folder to include a descriptive title (e.g., `2026-01-13-ai-coding-assistants`). This allows multiple posts on the same day.
+
 ### Manual Blog Post Creation
 
-1. Create a directory following the date pattern: `docs/posts/YYYY/MM/DD/`
+1. Create a directory following the date pattern: `docs/posts/YYYY/MM/DD/YYYY-MM-DD-title-of-post/`
+   - Example: `docs/posts/2026/01/13/2026-01-13-ai-coding-assistants/`
+   - The descriptive title allows for multiple posts on the same day
 
 2. Create an `index.md` file with the following frontmatter:
    ```yaml
@@ -122,7 +126,7 @@ These scripts will:
     ├── hosts/                 # Current hosts
     ├── past-hosts/            # Past hosts
     ├── sponsors/              # Sponsors
-    ├── posts/                 # Blog posts (YYYY/MM/DD/)
+    ├── posts/                 # Blog posts (YYYY/MM/DD/YYYY-MM-DD-title/)
     ├── assets/                # Images, logos
     └── stylesheets/
         └── extra.css          # Custom CSS

create_post.ps1

@@ -19,11 +19,12 @@ $tuesdayDate = $currentDate.AddDays($daysToTuesday)
 $year = $tuesdayDate.Year
 $month = $tuesdayDate.Month.ToString("D2")
 $day = $tuesdayDate.Day.ToString("D2")
+$date = $tuesdayDate.ToString("yyyy-MM-dd")
 
-
-
-# Define the folder path
-$folderPath = "docs/posts/$year/$month/$day"
+# Define the folder path with descriptive title placeholder
+# Format: YYYY-MM-DD-title-of-post (allows multiple posts per day)
+$postSlug = "$date-title-of-post"
+$folderPath = "docs/posts/$year/$month/$day/$postSlug"
 
 # Create the folder if it doesn't exist
 if (-Not (Test-Path -Path $folderPath)) {
@@ -35,7 +36,6 @@ $filePath = "$folderPath/index.md"
 
 # Create the markdown file with YAML front matter
 $title = "Your Blog Post Title"
-$date = $tuesdayDate.ToString("yyyy-MM-dd")
 
 $yamlContent = @"
 ---
@@ -55,4 +55,6 @@ Everyone and anyone are welcome to [join](https://weeklydevchat.com/join/) as lo
 # Write the content to the file
 Set-Content -Path $filePath -Value $yamlContent
 
-Write-Output "Blog post template created at $filePath"
+Write-Output "Blog post template created at $filePath"
+Write-Output "Remember to rename the folder with a descriptive title!"
+Write-Output "Example: Rename-Item '$folderPath' '$date-your-topic-here'"

create_post.sh

@@ -13,8 +13,10 @@ year=$(date -d "$tuesday" +%Y)
 month=$(date -d "$tuesday" +%02m)
 day=$(date -d "$tuesday" +%02d)
 
-# Define paths
-folder_path="docs/posts/$year/$month/$day"
+# Define paths with descriptive title placeholder
+# Format: YYYY-MM-DD-title-of-post (allows multiple posts per day)
+post_slug="${tuesday}-title-of-post"
+folder_path="docs/posts/$year/$month/$day/$post_slug"
 file_path="$folder_path/index.md"
 
 # Create the directory (including parents) if it doesn't exist
@@ -36,4 +38,6 @@ Everyone and anyone are welcome to [join](https://weeklydevchat.com/join/) as lo
 ![alt text](${tuesday}_image_filename.webp)
 EOF
 
-echo "Blog post template created at $file_path"
+echo "Blog post template created at $file_path"
+echo "Remember to rename the folder with a descriptive title!"
+echo "Example: mv '$folder_path' 'docs/posts/$year/$month/$day/${tuesday}-your-topic-here'"