blog-writing

name	blog-writing
description	Technical blog post writing for the OpenShift AI platform with Kubeflow

Write technical blog posts targeting ML engineers, data scientists, and platform operators using OpenShift AI with Kubeflow.

Article Structure

1. Hook: Start with the problem being solved or the capability being demonstrated
2. Context: Brief background on the relevant technology (KFP, Training Operator, Katib, KServe, etc.)
3. Content: Step-by-step walkthrough with code samples, diagrams, or benchmark results
4. Results: What the reader achieves, performance numbers, or key takeaways
5. Next steps: Links to documentation, notebooks, or related articles

Writing Guidelines

• Use clear, concise language. Avoid jargon without explanation.
• Include complete, runnable code samples (not snippets that won't work alone)
• Add diagrams for architecture, data flow, or ML pipeline topology
• Include benchmark numbers with methodology when discussing performance
• Keep articles focused: one topic per post, 1000-2000 words
• Use consistent terminology: "Kubeflow Pipelines" not "KFP" without first introduction

Review Process

1. Domain agent drafts the article
2. Technical Editor reviews for clarity, consistency, and polish
3. Revisions if needed
4. Final publish