GitHub Action Integration
The NextGen documentation is still under construction.
Automate Content Quality Checks in Your GitHub Workflows!
Tired of manually reviewing content quality in your repositories? Say hello to automated content analysis that integrates seamlessly with your existing GitHub workflows!
Acrolinx NextGen GitHub Action automatically analyzes your content files during pull requests, pushes, and manual workflows, ensuring your documentation and content consistently meet your brand standards and style guidelines. This powerful integration catches content issues early in the development process, preventing low-quality content from reaching your users.
The GitHub Action intelligently adapts to different GitHub events, analyzing only the files that matter for each workflow type. Whether youβre reviewing changes in a pull request, monitoring direct commits, or running comprehensive repository analysis, the action provides detailed feedback and actionable insights to maintain high content quality standards.
This guide will show you how to set up automated content quality checks using Acrolinx NextGen capabilities directly in your GitHub repositories, ensuring consistent brand alignment and proactive content governance.
GitHub Action Use Cases
The Acrolinx NextGen GitHub Action is designed to work seamlessly with different GitHub workflows and event types:
π Pull Request Analysis
- When to Use: Review content changes before merging
- What it Does: Analyzes only files modified in the pull request
- Benefits: Catch content issues early, ensure quality before merge
- Perfect For: Teams that want to maintain content quality gates
π Push Event Monitoring
- When to Use: Monitor direct commits to branches
- What it Does: Analyzes files changed in the push
- Benefits: Quick feedback on direct commits, maintain quality standards
- Perfect For: Small teams or solo developers
π§ Manual Workflow Analysis
- When to Use: Comprehensive repository-wide content audit
- What it Does: Analyzes all supported files in the repository
- Benefits: Complete content health assessment, identify areas for improvement
- Perfect For: Regular content audits, compliance checks
π Continuous Content Monitoring
- When to Use: Ongoing quality assurance for content repositories
- What it Does: Runs on schedule or manual triggers
- Benefits: Proactive content quality management, trend analysis
- Perfect For: Documentation teams, content-heavy projects
Prerequisites
To set up the Acrolinx NextGen GitHub Action, youβll need:
- A GitHub repository with content files you want to analyze
- A valid Acrolinx NextGen API Key. Donβt have one yet? Join the waitlist, and weβll email you once your access is approved.
- GitHub Actions enabled in your repository
- Content files in supported formats (Markdown, Text)
- GitHub repository secrets configured for secure API key storage
Supported File Types
The GitHub Action automatically detects and analyzes the following file types:
- Markdown:
.md
,.markdown
- Text:
.txt
The action intelligently filters files based on their extensions, ensuring only relevant content is analyzed.
Quick Start Guide
1. Add the Action to Your Repository
Create a .github/workflows/acrolinx-analysis.yml
file in your repository:
2. Configure Repository Secrets
- Go to your repositoryβs Settings β Secrets and variables β Actions
- Add a new repository secret:
- Name:
ACROLINX_API_TOKEN
- Value: Your Acrolinx NextGen API key
- Name:
3. Customize Analysis Settings
The action supports various configuration options:
Advanced Configuration
Event-Specific Workflows
Pull Request Analysis
Push Event Monitoring
Manual Repository Analysis
Action Outputs
The GitHub Action provides detailed outputs that you can use in subsequent workflow steps:
Available Outputs
event-type
: The type of GitHub event that triggered the action (push
,pull_request
,workflow_dispatch
)files-analyzed
: Number of files that were analyzedacrolinx-results
: JSON string containing detailed analysis results
Using Outputs in Workflows
Pull Request Integration
Automatic PR Comments
When the action runs on pull requests, it automatically:
- Analyzes changed files in the pull request
- Creates or updates comments with detailed analysis results
- Provides actionable feedback for content improvements
- Shows quality scores for each analyzed file
PR Comment Features
- π Quality Score Summary: Overall content quality assessment
- π― Issue Details: Specific problems found with suggestions
- π Score Breakdown: Detailed scores for quality, clarity, grammar, style, tone, and terminology
- π§ Improvement Suggestions: Actionable recommendations for content enhancement
Example PR Comment
π Acrolinx Analysis Results
This summary was automatically generated by the Acrolinx Analyzer GitHub Action for pull_request event.
π Summary
Overall Quality Score: π‘ 71
Files Analyzed: 4
Analysis performed on 7/24/2025, 11:30:11 AM Quality Score Legend: π’ 80+ | π‘ 60-79 | π΄ 0-59 Configuration: Dialect: american_english | Tone: formal | Style Guide: microsoft Event: for workflow_dispatch event
Commit Status Integration
The action can optionally update commit status to provide quick feedback:
Status Indicators
- β Success: All analyzed files meet quality thresholds
- β οΈ Warning: Some issues found but within acceptable limits
- β Failure: Critical issues that need immediate attention
Configuration
Troubleshooting
Common Issues
Action Not Triggering
- Check file paths: Ensure your workflow includes the correct file patterns
- Verify event triggers: Confirm the workflow is set to run on the desired events
- Check branch filters: Make sure the workflow runs on your target branches
API Token Issues
- Invalid token: Verify your Acrolinx API token is correct and active
- Token permissions: Ensure the token has the necessary permissions for content analysis
- Secret configuration: Check that the secret is properly configured in repository settings
No Files Analyzed
- File type support: Verify files have supported extensions (
.md
,.txt
) - File content: Ensure files contain actual text content
- File size: Check that files are not empty or too large
Analysis Failures
- Content format: Ensure content is in a readable text format
- API limits: Check if youβve exceeded API rate limits
- Network issues: Verify GitHub Actions can reach Acrolinx services
Best Practices
Workflow Design
- Target Specific Paths: Use path filters to run analysis only on content directories
- Event-Specific Workflows: Create different workflows for different use cases
- Quality Gates: Use the action as a quality gate in pull request workflows
- Scheduled Audits: Run regular repository-wide analysis for ongoing quality monitoring
Configuration Management
- Environment Variables: Use repository secrets for sensitive configuration
- Consistent Settings: Maintain consistent analysis settings across workflows
- Version Pinning: Pin to specific action versions for stability
- Documentation: Document your analysis configuration and quality standards
Team Integration
- Quality Standards: Establish clear quality thresholds and expectations
- Feedback Loop: Use PR comments to provide constructive feedback
- Training: Help team members understand and act on analysis results
- Continuous Improvement: Regularly review and adjust quality standards
Expected Outcomes
Once properly configured, the Acrolinx NextGen GitHub Action will:
- Automatically analyze content on every relevant GitHub event
- Provide detailed feedback through PR comments and commit status
- Maintain consistent quality across your content repository
- Reduce manual review effort while improving content standards
- Enable proactive content governance with early issue detection
The action transforms your GitHub workflow into a comprehensive content quality management system, ensuring your documentation and content consistently meet your brand standards and style guidelines.
Working Example
To see the Acrolinx NextGen GitHub Action in action, check out our test repository. This repository demonstrates:
- Real-world implementation of the GitHub Action
- Sample workflows for different use cases
- Example content files with various quality issues
- PR comments and commit status examples
- Configuration variations for different scenarios
What Youβll Find in the Test Repository
.github/workflows/
: Complete workflow configurationsdocs/
: Sample documentation files for testingREADME.md
: Repository setup and usage instructions- Pull Request examples: Real PR comments and analysis results
- Configuration examples: Different analysis settings and use cases
Visit github.com/acrolinx/github-action-testdata to explore the working example and see how the action performs in a real repository environment.