Workbench best practices

Purpose: This document provides best practices for day-to-day use of Workbench.

Introduction

Verily Workbench provides users with a wide range of features to manage and work with biomedical data. Below are some best practices for all Workbench users.

Always use source control

Workbench apps are remote virtual machines that could possibly get into a bad state or be affected by a GCP outage. To ensure you don't lose your work, make it a daily habit to push your changes to a remote GitHub repository. Read Git integrations with cloud apps to learn more about connecting your private GitHub repositories to Workbench via SSH key.

Store data resources in workspace buckets

Consider saving any intermediate data resources that are on your Workbench app to a workspace-controlled bucket. This can include logs, WDL workflows, intermediate ML outputs, and .PNG files containing data visualizations.