Notra can transform significant features, architectural decisions, and product milestones into comprehensive blog posts that tell the story behind your work.Documentation Index
Fetch the complete documentation index at: https://docs.usenotra.com/llms.txt
Use this file to discover all available pages before exploring further.
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 typeblog_post:
changelog: Comprehensive update listslinkedin_post: Social media updatestwitter_post: Short-form social contentinvestor_update: Investor updates
How Blog Posts Differ from Changelogs
| Aspect | Changelog | Blog Post |
|---|---|---|
| Purpose | Comprehensive list of changes | Narrative around specific features |
| Scope | All changes in a timeframe | Selected highlights worth exploring |
| Structure | Summary + categorized lists | Introduction + deep dive + conclusion |
| Tone | Informative and complete | Engaging and explanatory |
| Length | 500-1500 words | 1000-3000+ words |
| Frequency | Regular (weekly/monthly) | Occasional (as needed) |
Generation Options
Manual Triggers
Blog posts work best when triggered manually for specific features or milestones:- Navigate to Content in your dashboard
- Click Create → Blog Post
- Select relevant repositories and timeframe
- Provide context about what to focus on
- Let Notra’s AI generate the first draft
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
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:- Generate: Let Notra create the first draft
- Structure: Verify the narrative flow and organization
- Expand: Use AI to add detail where needed
- Polish: Refine tone, add examples, check technical accuracy
- Review: Get team feedback on technical accuracy
- Publish: Copy the Markdown to your blog platform
Example Blog Post Structure
Impact
Since launching email verification:- 40% increase in registration completion
- 60% reduction in password reset requests
- 95% user satisfaction score