How to Submit Edits Using Comala

Owned by Jessica Marshall
Last updated: Jan 14, 2021
3 min read

Overview

The Comala Document Management system is used to monitor and regulate the publishing of documentation in Confluence. Before a Confluence page can be published and viewable to the public, new Confluence pages and new page edits will need to be submitted for approval and will go through an approval process. The Comala Document Management system is functioning on customer facing pages in the USF IT Documentation space and does not change the ability for Confluence users to edit pages and sections they can edit currently. The system does not affect permissions in Confluence, only when and how pages are approved and published.


Table of Contents

 Click here to expand if you are new to editing Confluence pages...
  1. Log into Confluence 
  2. Navigate to the page to be edited 

  3. Click Edit (see image below)
    Click edit in the upper right corner

    NOTE: When editing pages please consult resources such as Confluence On-Prem User Guide Style Guide to make sure pages are formatted correctly for approval.

  4. Edit your page 
  5. Click Update found on the bottom right (see image below)
    Click update in the lower right corner

Before Submitting

Make sure all needed edits are complete before submitting so that your edits can be reviewed all at once

Submitting a Confluence Page for Approval 

After creating a new page or making page edits, you will need to submit your page for approval before it can be published. 

  1. Click Submit located under the title of the Confluence document (see image below)
    Click submit located under the title of the Confluence document

  2. Add comment (see image below)
    Add a comment in the comment section

    The comment should specify if a new page was created. For page edits, please include a short description of what has been changed so that the approvers can review the changes made. 

  3. Click Submit (see image below) 

    Click the submit button
    Back to Top 

    What to Expect When a Page is Submitted

    • After clicking Submit, the status of the page will change to 'In Review'. 

                a. In Review status (see image below)

    State has changed to In Review
    • You will receive an email notification when a JIRA ticket is created and an approver will review the page. If the page is approved, you will receive an approval email and the page will be published by the approver. 

               b. Published status (see image below) 

    State has changed to Published

    • If the page is not approved, you will receive an email requesting additional page edits. After completing the additional page edits, you will have to resubmit the page for approval. This process will repeat until the page is approved and published. 

Resubmitting a Confluence Page for Approval 

Update the page with the requested page edits 

  1. Click Resubmit (see image below) 
    Click resubmit located under the title of the Confluence document

  2. Add comment (see image below) 
    Add a comment in the comment section

    Please comment that the page is being resubmitted for approval and specify what changes have been made. 

  3. Click Submit (see image below) 
    Click the submit button

    You will receive an email to let you know if additional changes need to be made or if the page has been approved and published. 

    Back to Top