Update blog post directory structure for descriptive titles #73
Conversation
There was a problem hiding this comment.
Pull request overview
This PR updates the blog post directory structure to include descriptive titles in the folder names, enabling multiple posts on the same day. The change moves from YYYY/MM/DD/ to YYYY/MM/DD/YYYY-MM-DD-title-of-post/ structure.
Changes:
- Updated both bash and PowerShell post creation scripts to generate folders with descriptive title placeholders
- Added guidance messages reminding users to rename folders with descriptive titles
- Updated all documentation (README.md and AGENTS.md) to reflect the new directory structure
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| create_post.sh | Modified to create nested folder structure with date-prefixed title placeholder and added rename guidance |
| create_post.ps1 | Modified to create nested folder structure with date-prefixed title placeholder and added rename guidance |
| README.md | Updated documentation to describe the new directory structure and manual creation steps |
| AGENTS.md | Updated agent documentation with new directory structure throughout all references |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| 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'" |
There was a problem hiding this comment.
The Rename-Item example is incorrect. It attempts to rename the full path to just the date and topic, but should rename to the full path with the new slug. The correct target should be 'docs/posts/$year/$month/$day/$date-your-topic-here' to match the bash script's mv example pattern.
| Write-Output "Example: Rename-Item '$folderPath' '$date-your-topic-here'" | |
| Write-Output "Example: Rename-Item '$folderPath' 'docs/posts/$year/$month/$day/$date-your-topic-here'" |
|
Multiple posts are already allowed on the same day. You don't have to use 
|
|
@normanlorrain, how do you order the posts if they are in the same folder? I'm assuming the name of the file. If that is the case, we can prefix the posts with a number: Should we make it a habit to add the topic to the filename or just leave it as index? I like the idea of deleting this PR and adopting the number naming convention in the rare case we have multiple posts on the same day. |
|
Having a couch potato day, so I asked grok https://grok.com/share/c2hhcmQtMg_c68b2ba3-bfa5-4e63-9625-c38eefc6cabb Especially the second part. I'll try to get a link to documentation. |
Revise the blog post directory structure to include descriptive titles, allowing multiple posts on the same day. Update post creation scripts to reflect this new structure and provide guidance for renaming folders.