How to test 2.0.0 beta releases

As moving from any version of the 1.x.x series to any version of 2.x.x series requires some migrations to be applied, hence testing for any of the beta version of 2.0.0 will require few extra steps compared to the other beta version.

During the testing phase, will be releasing multiple beta version, such as 2.0.0-beta-1, 2.0.0-beta-2, etc…, Where in each new beta version will make few enhancements and bug fixes, so when you will install each of this new beta version, you should following the below steps to properly and thoroughly do the testing, to make the next series ready for release.

Keep an eye on the GitHub releases section to find out if there are any latest beta versions has been released for this new Task Board series.

Please following the below steps one-by-one :

Step 1 : Download the test vault

In every beta release version, at the end of the release notes, you will find a zip file attached. Which you can easily download, unzip and open inside Obsidian as a vault. Whatever changes you do inside this test vault, will not affect any other vault in your computer, so its completely safe.

Step 2 : Use the plugin for a while, specially the Map view

Now, in this test vault, you will notice there are mainly two plugin (there can be few more plugins too), Task Board, and BRAT. The version of the Task Board plugin will be from the latest version from the older series, 1.x.x. Mostly it will be 1.10.2.

You are now supposed use this version for a while. This is because, the main testing we will be doing for the upcoming version 2.0.0 release is to test, whether the migration code is properly working or not. You can read more about how the migrations will be applied and everything from here : Migrating to Task Board 2.x.x series.

So, as we want to ensure that the map view data is properly being migrated or not, we should use the map view feature extensively and then verify whether, after migrating to the beta version, the map view data has been properly moved or not.

Step 3 : Install the beta version

Now, open the BRAT plugin settings, and navigate to the “Beta plugin list”, where you will find the Task Board plugin has already been registered, as shown in the below image :

Click on the Edit icon button which will open a modal for you to select a different version for the Task Board plugin.

Select the beta version, you want to update to. For example, 2.0.0-beta-1. If you see any newer beta version, such as 2.0.0-beta-4, please update to the newest beta version.

Step 4 : Run the migrations

As soon as Task Board version has been updated to the beta version, a notice will be shown, with button on it, called Run migrations. When you will click on this button, the following migrations modal will open :

On this modal, click on the Run migrations button.

After the migrations has been successfully applied, you will be asked to reload the vault, simply click on the button to reload the vault and now you can start testing the new beta version, its features and everything.

If you face any issues during migration, please report the same on GitHub ticket.