Integration with Scroll Viewport

Capable Publishing integrates seamlessly with Scroll Viewport to provide a robust, controlled workflow for publishing Confluence content to the internet. By combining Capable’s approval and publishing capabilities with Scroll Viewport’s static site generation, you can ensure only vetted, up-to-date content appears on your public documentation site.

This guide walks you through how to set up and manage a publishing workflow using Capable Publishing and Scroll Viewport.


#Overview of Workflow

  1. Content Creation and Review
    Authors create and edit content in a working space in Confluence.

  2. Approval with Capable Publishing
    Articles are submitted for review using Capable Approval, where stakeholders review and approve updates.

  3. Publishing to a Target Space
    Approved content is published by Capable to a dedicated Scroll Viewport space.

  4. Scroll Viewport Publishing
    Scroll Viewport picks up the published content from the target space and generates the public site.


#Step-by-Step Setup

#1. Prepare Your Spaces

  • Source (Draft) Space
    Use this as the working space for internal documentation authors. This is where Capable Publishing's approval process will be configured.

  • Target (Published) Space
    This space will receive approved content from Capable Publishing. Configure Scroll Viewport to use this space as the content source for your public site.

#2. Configure Capable Approval and Publishing

Capable allows you to create approval workflows for individual pages or entire spaces. Here’s how to configure it:

  • Enable Capable in your Draft Space: Ensure Capable Publishing is active in the space.

  • Define an Approval Workflow:

    • Set up reviewers and approval rules.

  • Set the Target Space:

    • In Capable Publishing, specify the target space as the Scroll Viewport space.

    • This tells Capable where to publish once a page is approved.

#3. Publishing Approved Content

Once a page or group of pages is approved:

  • Use the Publish button in Capable to publish the content to the target space.

  • Capable will copy over the page hierarchy, attachments, and metadata as needed.

#4. Configure Scroll Viewport

  • In Scroll Viewport, configure the target space (from Step 2) as the content source.

  • Customize the theme, domain, and other settings as required.

  • When ready, deploy the site. Scroll Viewport will publish the content that Capable has delivered.


#Benefits of This Integration

  • Separation of Draft and Published Content
    Keep internal collaboration and editing separate from public content.

  • Controlled Publishing
    Ensure content is reviewed and approved before it goes live.

  • Repeatable, Scalable Workflow
    Ideal for teams managing product docs, release notes, or support knowledge bases.

  • Public-Ready Output
    Scroll Viewport provides a polished, branded web presence powered by your approved Confluence content.


#Example Use Case

Product Documentation Site:

  • Authors work in DOCS-DRAFT

  • Capable handles reviews and approvals

  • Approved content is published to DOCS-PUBLIC

  • Scroll Viewport builds and hosts docs.company.com from DOCS-PUBLIC