Swallow
  • YOUR FIRST MODEL
    • Setting up your first project
    • Manual setup of a new product
    • Excel Model Upload
    • Create your team
    • Essential concepts
      • Syntax
      • Steps
      • Collections
      • Try Model
      • Spotlight
  • PROCESS
    • Team Management
    • Governance & Collaboration
  • BUILD
    • Building with AI
    • Step builder
      • Understanding step types
      • Ordering step blocks
      • Placeholder mode
      • Up/Downloading models
      • Sharing your model
      • Running tests
    • Inputs
    • Enriching Raw Data
      • Transform Data
      • Enrich via API
      • Data Set
      • Collection
      • Custom Code
    • Setting Up Decisions
      • Exclusions
      • Excesses
      • Endorsements
      • Refer
    • Making Calculations
      • Factors
      • Calculation
    • Outputs
  • TEST
    • Creating New Tests
    • Running Tests
    • Editing Tests
    • Reading & Interpreting Tests
    • Impact Testing
  • DATA
    • Working with real-time data
    • Data Views
    • Data Quotas
    • Troubleshooting
    • API Webhooks
    • Data Downloads
  • ADMIN & SETTINGS
    • Project Management
    • Account Management
  • INTEGRATIONS
    • Introduction
    • Payments
      • Stripe
      • GoCardless
      • Adyen
    • Alerting
      • Slack
      • Zapier
    • Data
      • AWS S3
      • Google Sheets
    • Admin
      • Socotra
      • Guidewire
      • Hubspot
      • Salesforce
  • Developer API
    • Introduction
    • Authentication
    • Errors codes
    • Endpoints
      • /quotes
      • /projects
      • /tests
      • /process
Powered by GitBook
On this page
  • Writing release notes
  • Uploading & storing assets related to your version
  • Creating tasks & marking tasks completed
  • Reviewing version changes
  • Approving your version
  • Publishing your version
  • Creating a new version
  • Deleting draft versions
  1. PROCESS

Governance & Collaboration

Working with your team to build, edit, approve and evaluate a pricing model

PreviousTeam ManagementNextBuilding with AI

Last updated 1 year ago

Writing release notes

Whether you've built the first version of a totally new pricing model, or you're making changes to a new version, the best way to keep all of your team members in the loop is to summarise the changes in release notes.

At the top of each draft version on the 'Process' tab, you'll have the option to write your own summary or generate a summary with AI in the top right.

Use rich text formatting to write your own summary, or get Swallow to write the release notes for you automatically, based on the changes you've made to your model.

Whichever option you choose, you'll be able to edit the notes at any time before you've clicked the final 'Approve' button to lock in any changes. You won't be able to edit the release notes once your version is approved.

All notes will be viewable from the project overview screen, whether on a draft or approved version.

Uploading & storing assets related to your version

Upload any files or documents that support the price change that’s been made to give any reviewers wider context, such as presentations about a price change that were made to an internal committee.

Accepted file types currently include PDF, PPT, TXT, XLS & CSV.

This will help you build an internal knowledge base about your model, and is useful from a regulatory perspective as you'll have a paper trail for audits in one place.

Creating tasks & marking tasks completed

Any team member can add to the checklist of task items for the model.

These could be actions from meeting, or standard processes that must be completed before your model can be approved and published.

Tasks are optional, there is no setting to enforce all checkboxes on the task list to be ticked before a model version can be approved. However, the approver can choose to not to approve if tasks are not completed.

Reviewing version changes

You can review a brief summary of changes to the latest version build, showing steps added, changed or deleted. This is a detailed model view. It shows the exact model changes.

Approving your version

Once you're happy your pricing model version, all project team members with approval permissions must switch the approval toggle in the 'Version Team' section to approved.

Once all members of the version team have changed their toggle to approve the model, the 'Approve' button in the left-hand navigation bar can only be clicked by member of the team with an approver role. This will lock in all changes to the current version. This will then become the basis of the next version.

Publishing your version

Once your model is approved, a 'Publish' button will appear.

On published, the new model version will be distrobuted to the cloud and served on the project URL. This can take up to 5 minutes for the model to be served globally.

Creating a new version

To create a new version from the most recently approved or published model, click the 'Create New Version' button in the top right of your screen. This will create a new draft model for you to edit.

Deleting draft versions

To delete a current draft version of your pricing model, click the 'Delete' button on the left-hand side of the screen on the 'Process' tab.

Please note, this action cannot be undone, and deleted versions are not archived anywhere.

If you have admin permissions, you may want to go to the account-level in theAccount Management section to see account-level actions in more detail.

audit screen
Summary options buttons
Approval toggle in its 'Not approved' state
Approve button
Create New Version button
Control panel for a current draft version