Set Up Linear for Proactive Suggestions
When your engineering team ships product changes in Linear, your Help Center documentation can quickly fall out of date. Pageloop bridges this gap by connecting directly to your Linear workspace and monitoring completed issues for changes that affect your documentation. Instead of manually tracking every product update, Pageloop automatically analyzes completed engineering work and generates actionable suggestions to create new articles or update existing ones, keeping your Help Center accurate for both customers and support AI agents.
How Pageloop Uses Linear to Identify Documentation Needs
Pageloop focuses on completed issues in the Linear team you select. When an issue is marked as done, Pageloop examines its title, description, labels, comments, and any linked resources (such as attached pull requests or parent and child issues) to understand what changed in your product.
Based on this analysis, Pageloop may generate one of two types of suggestions:
Update suggestion: Recommends changes to one or more existing Help Center articles that may now be outdated because of the completed work.
New article suggestion: Recommends creating an entirely new article when the completed issue covers functionality that is not yet documented.
Pageloop groups related issues into broader documentation topics rather than creating a separate suggestion for every single issue. This means you receive focused, actionable suggestions instead of a long list of individual items.
Connect Pageloop to Linear
To connect your Linear workspace to Pageloop, follow these steps:
Navigate to Settings > Integrations in Pageloop.
Find Linear in the list of available data source integrations and click Connect.
You will be redirected to Linear's authorization page. Review the permissions Pageloop is requesting (read access to your workspace) and click Authorize to grant access.
After authorization, you will be redirected back to Pageloop. A configuration dialog will open automatically, displaying your Linear workspace name and a list of your Linear teams.
You must be an admin in Pageloop to connect integrations. If you do not see the option to connect, check with your team's Pageloop admin.
Select a Team to Monitor
After connecting your Linear workspace, Pageloop needs to know which team to monitor for completed issues. In the configuration dialog:
Review the list of available teams. Each team displays its name, team key, privacy status (public or private), and member count.
Select the team whose completed issues are most relevant to your documentation. This is typically your main product or engineering team.
Click Save Configuration to confirm your selection.
You can monitor one Linear team at a time. If your organization uses multiple teams and you want to change which team Pageloop monitors, you can update your selection by disconnecting the Linear integration from Settings > Integrations and reconnecting it. During reconnection, the team selection dialog will appear again so you can choose a different team.
What Happens After Setup
Once your Linear team is configured, Pageloop periodically scans for recently completed issues. The system fetches all issues that moved to a completed state since the last scan, analyzes them against your existing Help Center content, and generates suggestions when it finds documentation gaps or outdated information.
New suggestions appear in the Suggestions tab under the Newly Detected section.
After setup, allow some time for the first suggestions to appear. The exact timing depends on how frequently issues are completed in your selected team and when the next scheduled scan runs.
Example Scenarios
Here are common situations where Pageloop generates suggestions from Linear issues:
Bug fix that changes existing behavior: Your team completes an issue to fix a bug in the checkout flow. The fix changes how error messages are displayed. Pageloop suggests updating your Help Center article about the checkout process to reflect the new error handling.
New feature release: An issue for a new export feature is marked as done. Pageloop detects that no existing article covers this functionality and suggests creating a new article to document the export feature.
UI redesign: Several completed issues relate to a navigation redesign. Pageloop groups these issues into a single topic and suggests updating the relevant getting-started and navigation articles.
API changes: A completed issue describes changes to your API endpoints. Pageloop identifies the affected integration guides in your Help Center and suggests updates to keep them accurate.
Performance improvement: An issue for improving page load speed is completed. Pageloop evaluates whether this change affects any documented workflows or troubleshooting steps and only generates a suggestion if it impacts customer-facing documentation.
Manage Linear Suggestions
Suggestions generated from Linear issues appear alongside suggestions from other connected data sources (such as Slack or Intercom) in the Suggestions tab. Each suggestion includes:
Title: A descriptive name summarizing the documentation need
What changed: A summary explaining the product change or gap identified from completed issues
AI reasoning: An explanation of why Pageloop believes your documentation needs attention
Source logs: Links to the original Linear issues that triggered the suggestion, so you can review the full context
If Pageloop detects a new completed issue that relates to a suggestion already in the Newly Detected tab, it updates the existing suggestion with the additional context rather than creating a duplicate. This means a single suggestion can be informed by multiple related issues.
For detailed instructions on reviewing and acting on suggestions, see Working with Proactive Suggestions.
Frequently Asked Questions
Will Pageloop create suggestions for every completed issue?
No. Pageloop analyzes each completed issue and only generates a suggestion when it identifies a meaningful documentation gap or an outdated article. Routine maintenance tasks, internal tooling changes, and issues that do not affect customer-facing documentation are typically filtered out.
Can I monitor more than one Linear team?
Pageloop currently supports monitoring one Linear team per workspace. You can change which team is monitored by disconnecting and reconnecting the Linear integration from Settings > Integrations. The team selection dialog will appear during reconnection.
Why am I not seeing any suggestions from Linear?
There are a few reasons suggestions may not appear:
No recently completed issues: Pageloop only analyzes issues that have moved to a completed state. If no issues have been completed recently, there is nothing to analyze.
Team not configured: Make sure you have selected a team in the Linear configuration dialog. The integration remains inactive until a team is selected.
Allow time for processing: After initial setup, allow some time for the first suggestions to appear as Pageloop needs to run its next scheduled scan.
Issues do not affect documentation: If completed issues are primarily internal changes that do not impact your Help Center content, Pageloop may not generate suggestions.
What Linear permissions does Pageloop require?
Pageloop requests read-only access to your Linear workspace during the OAuth authorization step. This allows Pageloop to view team information and read completed issues. Pageloop does not modify any data in your Linear workspace.
Can I disconnect Linear and reconnect later?
Yes. You can disconnect the Linear integration from Settings > Integrations at any time. If you reconnect later, you will need to go through the OAuth authorization and team selection process again.