Release notes and deprecation policy
Where SourceLace tells you what changed, how much notice you get before something is removed, and the emails your admins receive.
SourceLace changes often: new connectors, new agent features, fixes. A release note is a short, plain description of one change, written by the people who made it. This page says where release notes appear once SourceLace publishes them, what each kind of note means, and how much notice you get before anything you use is removed.
Where release notes appear
When SourceLace publishes release notes, you find them in these places:
- What's new in the app. Everyone signed in sees What's new under Help in the menu. A dot next to it means a note was published since you last opened it. You can filter the list by kind of note and by area (such as agents or connectors).
- The Runners page. If your organization uses the SourceLace Runner, notes about the runner are also listed on the Runners page, with the runner version each one came with.
- The public release notes page on sourcelace.com, and its feed, which a feed reader can follow. They list the same notes, without anything about your organization.
- This page. The newest published notes are listed at the end of this page.
Each note says what changed and, where it matters, what to do. Notes never mention your organization's data.
Release notes start when SourceLace begins publishing them. Until then these places stay empty, and no release note emails are sent.
Kinds of release note
| Kind | What it means |
|---|---|
| Action required | An admin needs to do something, often by a date shown in the note. |
| New | Something you could not do before. |
| Improved | Something that works better than before. |
| Fixed | Something that did not work as it should and now does. |
| Security | A change that makes SourceLace safer. |
| Deprecated | Something that still works but will be removed on the date shown, with what to use instead. |
| Removed | Something that is no longer available. |
| Known issue | A problem we know about and are working on, and how to work around it. |
Some notes are for admins only, such as changes to settings only admins can see. Those appear for your admins and on the public page.
Emails to admins
Once SourceLace publishes release notes, your organization's admins get these emails:
- Notes that need action, and deprecations, when they are published. They always go to every admin, because something may stop working if nobody acts.
- Reminders before a removal, 90 days and 30 days before the removal date of something deprecated.
- A monthly summary of the month's notes, early the next month. Each summary has a link to stop it, and anyone can turn it off or on again on the What's new page.
Each email goes once. Runner notes go only to organizations that use the SourceLace Runner, by email and in What's new.
Deprecation policy
When SourceLace plans to remove something you may use, we deprecate it first: it keeps working, a Deprecated release note says when it will be removed and what to use instead, and your admins get the emails above.
- At least 6 months' notice before anything is removed.
- At least 12 months' notice for anything an Enterprise contract depends on, such as features of the SourceLace Runner and connections to your systems.
- The only exception is a security emergency: when keeping something would put your data at risk, it may be removed sooner. The release note then says that it is for security and why, and we tell your admins straight away.
The notice counts from the day the Deprecated note is published.
When something goes wrong
| What you see | What it means | What to do |
|---|---|---|
| No What's new in the menu | SourceLace has not published any release notes yet. | Nothing; it appears once notes are published. |
| An admin did not get a deprecation email | The person may not have been an admin when the note was published, or the email was filtered. | Check the What's new page, which lists every published note, and ask your mail team to allow email from SourceLace. |
| The monthly summary stopped | The summary was turned off for that person. | Turn Email me the monthly summary back on, on the What's new page. |