Using Brainfish to Generate Product Marketing Knowledge Articles from Videos and Session Replays

Overview

This article explains how product marketing teams can use Brainfish to automatically generate, review, and publish knowledge base articles from product marketing videos and session replays. This workflow helps keep marketing and product documentation accurate, relevant, and up to date with minimal manual effort.

Use Case

A product marketer wants to quickly create or update knowledge base content (for example, feature overviews, how-to guides, or campaign walkthroughs) based on existing product marketing materials, such as:

• Recorded product demos
• Feature launch videos
• Campaign walkthroughs
• User session replays showing real interactions and questions

Brainfish can analyze these assets and generate draft articles that the marketer can then review and approve.

Prerequisites

Before you start, ensure you:

• Have access to your Brainfish workspace with permissions to upload media and manage articles.
• Have product marketing videos and/or session replay recordings available.
• Know where in your knowledge base you want to add or update content.

How It Works

Brainfish uses AI to analyze visual and audio content in your videos or session replays:

• Computer vision identifies what is happening on screen, such as button clicks, navigation steps, and UI changes.
• Audio processing and transcription detect spoken intent, explanations, and instructions.

Based on this analysis, Brainfish generates draft articles that typically include:

• An overview of the topic or feature
• Step-by-step instructions that mirror the on-screen flow
• A closing summary or key takeaways

You can then review these drafts, make any edits, and approve them to publish into your knowledge base.

Generate Articles from Product Marketing Videos

1. Collect your videosPrepare the product marketing videos you want to convert into documentation, such as:
   • Feature demo videos
   • Launch announcement walkthroughs
   • Onboarding or explainer videos
2. Upload the video to Brainfish
   • Navigate to the area of Brainfish where you can upload media for article generation.
   • Upload your selected video file.
3. Allow Brainfish to analyze the videoBrainfish will:
   • Process the visual content to detect user interface elements and interactions.
   • Transcribe and interpret the audio track to understand the spoken narrative and intent.
4. Review the generated draft articleOnce processing is complete, Brainfish generates a draft article that includes:
   • A high-level overview of the feature or topic described in the video.
   • Step-by-step instructions that follow the actions shown on screen.
   • A brief summary capturing the main benefits or conclusions.
5. Refine the content (optional but recommended)
   • Edit the title to match your knowledge base naming conventions.
   • Adjust steps for clarity, tone, or additional context needed by your target audience.
   • Add screenshots, links, or related resources if needed.
6. Accept and publish the article
   • Use the review panel in Brainfish to confirm the structure and content.
   • Verify key steps using the embedded video snippets as reference.
   • Accept the suggestion to add or update the article in your knowledge base.

Generate Articles from Session Replays (Discover)

Use session replays when you want to capture real user behavior, questions, and friction points, and convert them into helpful content.

1. Identify valuable session replaysLook for replays that show:
   • Users struggling with a task
   • Frequently repeated questions or paths
   • Successful completion of key journeys you want to document
2. Open the Discover feature in Brainfish
   • Navigate to the Discover area in Brainfish.
   • Select or upload the relevant session replay.
3. Analyze the session replayBrainfish will:
   • Examine the user’s on-screen actions and navigation path.
   • Interpret any audio (if available) or on-screen text that signals intent or confusion.
4. Review suggested knowledge base itemsBased on its analysis, Brainfish generates suggested articles that may include:
   • New help topics addressing observed user questions.
   • Clarifications for confusing flows or UI elements.
   • Task-based guides based on actual user journeys.
5. Edit and refine
   • Review the proposed titles, overviews, and steps.
   • Ensure the content clearly addresses the underlying user intent seen in the replay.
   • Add any missing context, screenshots, or links.
6. Accept and publish suggestions
   • Use the review panel to validate each suggestion against the replay.
   • Accept suggestions to automatically create new articles or update existing ones in your knowledge base.

Review and Approval Workflow

Brainfish provides a centralized review panel to manage all AI-generated article suggestions.

1. Open the review panelAccess the area in Brainfish where suggested articles are listed.
2. Inspect each suggestion
   • Check the article’s structure (title, overview, steps, summary).
   • Use embedded video snippets or replay segments to verify accuracy.
   • Confirm that terminology and tone match your product marketing style.
3. Decide what to do with each suggestion
   • Accept to publish the article or apply the update to an existing article.
   • Edit to refine content before accepting.
   • Reject or archive if the suggestion is not useful or duplicates existing content.
4. Iterate as neededContinue feeding new videos and replays into Brainfish to keep your product marketing documentation aligned with product changes and customer needs.

Benefits for Product Marketing Teams

Using Brainfish for this product marketing use case provides several benefits:

• Faster content creation: Turn existing videos and replays into draft articles in minutes.
• Higher relevance: Base documentation on real user behavior and up-to-date marketing assets.
• Consistency: Maintain consistent structure and tone across articles with AI-generated templates.
• Collaboration: Enable product, marketing, and support teams to work from the same, centrally managed knowledge base.

Additional Resources

For detailed, product-specific instructions and UI screenshots, refer to:

• Generate, Review, and Accept Knowledge Base Article Suggestions from Videos and Session Replays

Use this workflow whenever you launch new features, update messaging, or notice recurring user questions in your analytics or session replays.