# Blogs

This folder contains supplemental blog posts designed for publication on Medium.com to highlight unique features and developer productivity aspects of this tutorial.

## Purpose

These blog posts serve to:
* **Highlight unique features** of the CAT pattern tutorial (e.g., git submodule workspace approach)
* **Focus on developer productivity** and practical benefits
* **Drive traffic to the main tutorial** via embedded GitHub links
* **Provide bite-sized, shareable content** for the developer community

## File Naming Convention

* **Blog posts:** `{topic}-MEDIUM.md` (e.g., `git-submodule-workspace-MEDIUM.md`)
* **Template:** `BLOG-TEMPLATE.md`

## Medium.com Compatibility

All blog posts follow the Medium.com formatting guidelines specified in [CLAUDE.md](../CLAUDE.md):
* ❌ NO tables (Medium.com doesn't support them)
* ✅ Bullet lists with em dashes (—)
* ✅ Emoji section headers for visual appeal
* ✅ Bold text for scannability
* ✅ Short paragraphs (2-3 sentences)
* ✅ Hero image placeholders
* ✅ Tags at the bottom

## Publishing Workflow

1. Write blog post following the template
2. Copy entire content to clipboard
3. Paste into Medium editor (medium.com/new-story)
4. Replace placeholder image with actual diagram
5. Preview and adjust formatting
6. Add tags from bottom of article
7. Publish or save as draft

## Blog Topics

Current and planned blog posts:

* **Git Submodule Workspace** — How to manage multiple repositories as a unified workspace
* **CAT Pattern Overview** — Quick introduction to Client, API, Token Service architecture
* **Authentication Flow Deep Dive** — OAuth 2.0 / OIDC implementation details
* **Developer Productivity** — Time-saving features and best practices

## Link to Main Tutorial

All blog posts should include a prominent link to the main tutorial:

📖 **Full Tutorial:** [Angular + .NET Tutorial on GitHub](https://github.com/workcontrolgit/AngularNetTutorial)
