> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryhamsa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Generate structured written content from transcripts using AI-powered templates

## What is AI Docs?

AI Docs generates structured written content based on completed transcripts. It uses AI-powered templates to transform audio transcriptions into various forms of written content, including social media posts, articles, summaries, FAQs, and more.

<Info>
  **AI Docs enables you to:**

  * Generate multiple content types from transcripts
  * Use template-based content generation
  * Customize output with audience and tone settings
  * Export content in multiple formats
  * Create professional written content automatically
</Info>

## Core Capabilities

### AI-Powered Text Generation

Transform transcripts into structured content:

* **Intelligent processing**: Advanced AI analyzes transcript content
* **Context understanding**: Maintains context and meaning
* **Multi-format output**: Generate various content types
* **Template-based**: Use predefined templates for consistency
* **Customizable**: Adjust audience, tone, and style

### Template-Based Content Creation

Choose from predefined templates:

* **Social media content**: Posts optimized for social platforms
* **Marketing copy**: Advertising and promotional content
* **Articles and blogs**: Full-length articles and blog posts
* **Summaries**: Condensed versions of content
* **FAQs**: Frequently asked questions
* **Custom templates**: Create and use custom templates

## Content Generation Capabilities

### Input Selection

* **Transcript selection**: Choose from completed STT transcripts
* **Multiple sources**: Use transcripts from various sources
* **Source validation**: Ensure transcript is completed
* **Source metadata**: View transcript details and context

### Content Categories

Generate content in various categories:

* **Social Media**
  * Twitter/X posts
  * LinkedIn articles
  * Facebook posts
  * Instagram captions

* **Marketing and Advertising**
  * Ad copy
  * Product descriptions
  * Promotional content
  * Email campaigns

* **Articles and Blogs**
  * Blog posts
  * News articles
  * Feature articles
  * SEO-friendly content

* **Business Content**
  * Meeting summaries
  * Business reports
  * Executive summaries
  * Documentation

* **Educational Content**
  * Study guides
  * Course materials
  * Educational articles
  * Training content

* **Technical Content**
  * Technical documentation
  * API documentation
  * Technical articles
  * Code explanations

### Generation Settings

Customize content generation:

* **Audience selection**: Target specific audiences
  * Public
  * Documentation
  * Internal Team

* **Tone selection**: Control writing tone
  * Friendly
  * Professional
  * Informative
  * Casual
  * Formal
  * Persuasive
  * Authentic

* **Language selection**: Choose output language
  * Arabic
  * English
  * Both (with primary selection)

* **Additional context**: Provide extra information
  * Participants list
  * Recording date
  * Description
  * Notes and instructions

## Content Management Capabilities

### Job Management

* **Job list**: View all AI Docs jobs
* **Status tracking**: Monitor job progress
* **Job details**: View generation settings and results
* **Job operations**: Edit, regenerate, delete jobs

### Content Review

* **Generated content**: View all generated content types
* **Content editing**: Edit generated content directly
* **Content comparison**: Compare different generations
* **Content validation**: Review for accuracy and quality

### Content Operations

* **Regenerate content**: Generate new content with different settings
* **Copy content**: Copy content to clipboard
* **Export content**: Download content in various formats
* **Delete content**: Remove unwanted outputs

## Supported Content Categories

### Social Media Posts

* **Platform-optimized**: Content tailored for specific platforms
* **Character limits**: Respects platform character limits
* **Hashtag suggestions**: Includes relevant hashtags
* **Engagement optimization**: Designed for engagement

### Web Articles (SEO-Friendly)

* **SEO optimization**: Search engine optimized content
* **Keyword integration**: Natural keyword inclusion
* **Structure**: Proper heading and paragraph structure
* **Readability**: Optimized for reading experience

### Summaries and Keywords

* **Key points extraction**: Identifies main points
* **Keyword extraction**: Highlights important keywords
* **Condensed format**: Shorter version of content
* **Bullet points**: Easy-to-scan format

### FAQs

* **Question generation**: Creates relevant questions
* **Answer extraction**: Provides answers from transcript
* **Organization**: Well-structured FAQ format
* **Completeness**: Comprehensive coverage of topics

## Content Customization

### Header and Footer

* **Custom headers**: Add company logos and titles
* **Footer information**: Include contact details
* **Branding**: Maintain brand consistency
* **Visual customization**: Customize colors and images

### Formatting Options

* **Text formatting**: Bold, italic, lists
* **Structure**: Headings, paragraphs, sections
* **Images**: Add and manage images
* **Links**: Insert and manage links
* **Colors**: Customize text and background colors

### Export Formats

Export generated content:

* **PDF**: Professional document format
* **DOCX**: Microsoft Word format
* **HTML**: Web-ready format
* **TXT**: Plain text format
* **JSON**: Structured data format

## Dependency Rules

### Transcript Requirement

AI Docs generation requires:

* **Completed transcript**: Must have a completed STT job
* **Transcript validation**: System verifies transcript status
* **Source linking**: Links AI Docs to source transcript
* **Source access**: Access to original transcript

### Workflow Integration

* **STT prerequisite**: Complete transcription first
* **Seamless integration**: Direct link from STT to AI Docs
* **Source preservation**: Maintains connection to source
* **Regeneration support**: Regenerate from same source

## Job Status and Processing

### Processing States

| Status           | Description                     | Next Action                  |
| ---------------- | ------------------------------- | ---------------------------- |
| **PENDING**      | Job is queued for processing    | Wait for processing to start |
| **IN\_PROGRESS** | Content is being generated      | Wait for completion          |
| **COMPLETED**    | Content generated successfully  | View and edit content        |
| **FAILED**       | Generation encountered an error | Review error and retry       |

### Status Tracking

* **Real-time updates**: See status changes in real-time
* **Progress indicators**: Visual progress feedback
* **Completion notifications**: Get notified when done
* **Error messages**: Clear error descriptions

## Use Cases

### Content Marketing

Create marketing content:

* **Social media campaigns**: Generate social media posts
* **Blog content**: Create blog posts from interviews
* **Email campaigns**: Generate email content
* **Ad copy**: Create advertising content

### Documentation

Generate documentation:

* **Meeting minutes**: Create structured meeting summaries
* **Process documentation**: Document procedures and processes
* **Training materials**: Create educational content
* **Knowledge base**: Build knowledge base articles

### Content Repurposing

Repurpose existing content:

* **Multi-format output**: Same content in different formats
* **Platform optimization**: Optimize for different platforms
* **Audience adaptation**: Adapt for different audiences
* **Tone variation**: Create different tone variations

### Research and Analysis

Support research activities:

* **Research summaries**: Summarize research interviews
* **Key findings**: Extract key points
* **FAQ generation**: Create FAQs from research
* **Report generation**: Generate research reports

## Key Features

### Intelligent Content Generation

* **Context awareness**: Understands transcript context
* **Content quality**: High-quality, coherent content
* **Template adherence**: Follows template structures
* **Customization**: Adapts to settings and preferences

### Multi-Format Output

* **Multiple templates**: Various content types from one transcript
* **Format optimization**: Optimized for each format
* **Export flexibility**: Multiple export options
* **Content reuse**: Use content across platforms

### Professional Quality

* **Grammar and style**: Professional writing quality
* **Consistency**: Consistent tone and style
* **Accuracy**: Maintains transcript accuracy
* **Completeness**: Comprehensive content coverage

## Getting Started

1. **Complete a Transcript**
   * Ensure you have a completed STT job
   * Verify transcript is ready for processing

2. **Create AI Docs Job**
   * Select the transcript source
   * Choose content category and template
   * Configure audience, tone, and language
   * Add additional context if needed

3. **Review Generated Content**
   * View all generated content types
   * Edit and refine content
   * Customize formatting and styling

4. **Export and Use**
   * Export in your preferred format
   * Use content across platforms
   * Share with your team

## What's Next?

* **[Creating AI Docs Jobs](./creating-jobs)** - Learn how to create AI Docs jobs
* **[Managing Content](./managing-content)** - Organize and manage generated content