Skip to main content
Once templates are merged in to master through GitHub, we have to manually publish them for our users. It’s a relatively simple process.

​
Publishing Process

​
1. Wait for Master Update

Wait a few hours after the merge has occurred for master to be updated and the template to be uploaded.

​
2. Navigate to Admin

Go to www.clearcalcs.com/admin/templates

​
3. Find Your Template

Go to your template - you should see an orange message telling you that there’s a newer unpublished version available: Unpublished Version Notice

​
4. Review Change Log

Double check the change-log and make sure the update severity is appropriate (this should have been set in the GitHub PR, but it’s worth a double-check).

​
Things to Check:

  • If this template removes beta status, note that in the changelog
  • Some large PRs may have different changes to different templates - ensure each template has the right changelog/update severity set
  • Coordinate with original PR creator if required
Change Log Review Update Severity

​
5. Check Beta Status

Double-check whether this template should be released as Beta. This should have been determined in the PR for the template creation or update. Check the “Beta” box if required.
Don’t remove Beta tags from previous versions! Publishing a non-beta version will remove the label from the menu the users see.
Beta Checkbox

​
6. Publish the Template

We’re all good to publish now!
  • Check the “Published” checkbox for the newest version
  • Uncheck the previous version
In some rare cases, we may decide to keep the previous version published and release the new one as a separate beta. In that case, it’s totally OK to have both sheets published - just make sure you’re flagging the right sheet as beta!
Publishing Checkboxes

​
7. Test the Template

As a good measure:
  1. Go to a project and create a sheet with the new template
  2. Make sure it’s all working fine
  3. Even better, try to upgrade from an existing sheet and confirm it’s working

​
8. Add to ClearCalcs Organization (New Templates Only)

If the template is new, make sure you add ClearCalcs as an organisation using the ID: 2ad7e5c6-8d23-416d-acb1-5487dc65150a This will make sure you can add a calculation of this new template in Prod.

​
Steps:

  1. Click on ‘Add to organisation’
  2. Copy-paste the organisation ID
  3. Click on ‘Add template to organisation’
Add to Organization Organization ID Entry

​
Template States and Severities

There are several different states that we can put templates in when we publish them:
  1. Severity: Usually set in the pull request, this sets whether the template change is adding a feature, fixing bug of class[X], or making the template obsolete
  2. Published/Unpublished: Whether or not the “Published” tickbox is marked affects what’s shown in the “Add New Calculation” menu, but also a few other things
  3. Beta: Whether a message should be shown to users indicating that we’re still testing the template
  4. Under Construction: A banner that can be applied via UserPilot
  5. Licenses: The set of users to whom the calculator should be made available
Template States Interface

​
Severity Levels

Severity Options One of seven severities must be set in order to publish a template. These indicate the type of change you’re making in the given template update:
Feature
  • Basically anything that’s not fixing a bug. We don’t sub-categorise these any further.
  • Displayed to users as: “Feature”
Class 0 - Meaningfully-caught Error
  • Displayed to users as: “Minor Bug Fix”
Class 1 - Uncaught Error
  • Displayed to users as: “Bug Fix”
Class 2a - Obviously Wrong Results
  • Displayed to users as: “Bug Fix”
Class 2b - Unobvious, Over-conservative Results
  • Displayed to users as: “Critical Bug Fix”
Class 3 - Unobvious, Unconservative Results
  • Displayed to users as: “Critical Bug Fix”
  • Special Effect: If any class 3 bug fix is present in a user’s project, then ClearCalcs will automatically open up the “Calculation Upgrades” screen by default
Obsolete - End-of-life Version
  • Displayed to users as: “Obsolete”
  • Special Effects:
    • Templates marked as obsolete will not be displayed in the “Add New Calculation” menu
    • Templates for which the most recent revision is marked as obsolete will not be allowed to be duplicated into a new project

​
Published/Unpublished States

Usually, this simply means whether or not to display the given template revision to our users in the “Add New Calculations” menu. However, there are some complex scenarios:
Multiple Published Versions: If multiple versions of the same template are published, then all of those versions will be displayed to users! They will be displayed one after the other within the template’s category with probably the same icon and name, so users may not be able to tell the difference.
Key Behaviors:
  • Multiple published versions: All versions appear in the menu (historically used when publishing one newer “beta” version and an older reliable version as non-beta)
  • Obsolete templates: Will NOT be displayed in the “Add New Calculations” menu regardless of published status
  • No published versions: Existing sheets still work, but calculator won’t appear in the “Add New Calculation” menu

​
Beta and Under Construction Status

Beta status indicates we’re still testing the template and shows a message to users accordingly. Under Construction banners can be applied via UserPilot for additional user communication.
⌘I