The landing page is your project overview - the questions you’re trying to answer, the data and analysis tools you'll use, etc. Good documentation makes your analysis easy to share (including with your future self) and reproduce.

Editing the dashboard (in the markdown language)
Click the pencil icon to the right of the "About the Workspace" header at the top to edit. The dashboard uses the markdown language, which lets you organize with headers and include links and additional references. 

To learn more about Best Practices for documenting in a dashboard, see this article.

Workspace information
These details are populated automatically in the right column of the Dashboard:

Each workspace comes with a bucket where data generated by a workflow analysis and notebook.ipynb files are stored by default. You can access the dedicated workspace bucket from the dashboard by clicking on the "Open in browser" link in the bottom of the right column.

	Storage classes
	All Terra buckets are Standard storage class buckets. We may support Nearline, Coldline, and Archive storage classes in the future, but they are not available at this time.

Uploading your own data
This will take you to the Google Cloud Platform (GCP) console, where you can upload smaller files from your local machine by clicking or dragging:  

For large numbers and/or large data files, you can also use gsutil in a terminal (access from the widget at the top right) to copy data from a local machine or other cloud storage. To learn more, see this article.`

Like spreadsheets built right into the workspace, data tables help keep track of all project data - so you don't have to remember where in the cloud all those files are. This becomes especially useful as the number of participants or samples in your study grows.

In Terra, you don't need to store input data in the workspace bucket. By including links to the data's actual location in the cloud, the data table can link data files to workspace tools. Workflows can input from the table and you can even associate generated data with the original by write output metadata to the workspace table. 

Learn how to combine data from different studies or across datasets into a single table:

Need to add a notebook?
You can create or upload a notebook.pjnb file from the Notebooks tab. Or copy a notebook from another workspace by clicking on the three vertical dot icon to the left of the notebook name:

Collect, configure (set up) and run workflows for bulk analyses from the Workflows tab. These are the sorts of repetitive analyses that can be automated, such as aligning sequencer reads or calling variants. You can set up and run workflows by clicking on the workflow name. Many options for saving costs - such as using call caching or preemptibles - are available in-app. 

Finding the workflow you need
Not a coding expert? Browse and import published workflows in Dockstore or the Broad Methods Repository by selecting the "Find a Workflow" option: 

Here is where to check on the status of workflow submissions. The Job History tab includes a record of every workflow submission.

Troubleshooting
You can troubleshoot failed flows by selecting the workflow name in the "Submission" column:

Error logs
When troubleshooting, continue to select "View" for more details, including error logs (click on the icons at right):

To collaborate, you can "share" the project workspace that contains all the data, tools and analysis work done. Workspace owners control how much access collaborators have to the resources, including funding, by assigning roles with different permission levels.