Skip to main content
Notra can transform significant features, architectural decisions, and product milestones into comprehensive blog posts that tell the story behind your work.

Overview

Blog posts in Notra are designed for deeper storytelling than changelogs. They’re ideal for:
  • Feature announcements: Deep dives into major new capabilities
  • Technical deep dives: Architecture decisions, performance optimizations, and engineering challenges
  • Release highlights: Combining multiple features into a cohesive product update
  • Behind-the-scenes: The story of how and why you built something
Blog posts pull from the same GitHub data as changelogs but use a different narrative structure focused on storytelling and context rather than comprehensive change lists.

Content Type

In Notra’s database, blog posts are stored with the content type blog_post:
This distinguishes them from other content types like:
  • changelog: Comprehensive update lists
  • linkedin_post: Social media updates
  • twitter_post: Short-form social content
  • investor_update: Investor updates

How Blog Posts Differ from Changelogs

Generation Options

Manual Triggers

Blog posts work best when triggered manually for specific features or milestones:
  1. Navigate to Content in your dashboard
  2. Click CreateBlog Post
  3. Select relevant repositories and timeframe
  4. Provide context about what to focus on
  5. Let Notra’s AI generate the first draft
The more context you provide, the better the output. Include details about user impact, technical challenges overcome, and the “why” behind decisions.

Event-Based Triggers

You can also configure blog post generation for major releases:
Event-based blog post generation is best suited for major releases where you want automatic draft creation. You’ll still review and refine before publishing.

Writing with AI Assistance

Notra’s AI editor helps you craft compelling blog posts:

Expand on Technical Details

Select a section and ask the AI to:
  • “Explain the technical implementation in more detail”
  • “Add code examples for this feature”
  • “Describe the performance improvements with metrics”

Adjust Tone and Audience

  • “Make this section more accessible for non-technical readers”
  • “Add more technical depth for a developer audience”
  • “Rewrite this in a more conversational tone”

Improve Structure

  • “Add a section about migration steps”
  • “Include a comparison with the previous approach”
  • “Add a conclusion section with next steps”

Best Practices

Focus on One Main Topic

Unlike changelogs that cover everything, blog posts should have a clear narrative thread: Good: “How We Reduced API Response Time by 60%“
Poor: “March 2026 Product Updates”

Include Context and Motivation

Help readers understand:
  • The problem: What challenge were you solving?
  • The solution: How did you approach it?
  • The impact: What changed for users?
  • The learnings: What would you do differently?

Use Your GitHub Data Strategically

Notra can pull:
  • PR descriptions for implementation details
  • Commit messages for technical context
  • Release notes for version history
  • Issue discussions for problem background
But you decide what to highlight and how to frame it.

Add Visual Context

While Notra generates the text, consider adding:
  • Architecture diagrams
  • Before/after screenshots
  • Performance charts
  • Code snippets
You can upload images to your Notra workspace and reference them in your blog posts using standard Markdown image syntax.

Plan Your Publishing Workflow

Blog posts typically need more review and polish than changelogs:
  1. Generate: Let Notra create the first draft
  2. Structure: Verify the narrative flow and organization
  3. Expand: Use AI to add detail where needed
  4. Polish: Refine tone, add examples, check technical accuracy
  5. Review: Get team feedback on technical accuracy
  6. Publish: Copy the Markdown to your blog platform

Example Blog Post Structure

[Technical details developers care about]

Impact

Since launching email verification:
  • 40% increase in registration completion
  • 60% reduction in password reset requests
  • 95% user satisfaction score
[Metrics and user feedback]

What’s Next

We’re already working on social authentication and passkey support… [Future roadmap and next steps]
Last modified on July 6, 2026