# Working in projects #

A project is a collaborative workspace where you work with data and other assets to accomplish a particular goal\.

By default, your [sandbox project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/sandbox.html) is created automatically when you sign up for watsonx\.ai\.

Your project can include these types of resources:

<!-- <ul> -->

 *  [Collaborators](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-projects.html?context=cdpaas&locale=en#collaboration) are the people who you work with in your project\.
 *  [Data assets](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-projects.html?context=cdpaas&locale=en#data) are what you work with\. Data assets often consist of raw data that you work with to refine\.
 *  [Tools and their associated assets](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-projects.html?context=cdpaas&locale=en#tools) are how you work with data\.
 *  [Environments](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-projects.html?context=cdpaas&locale=en#env) are how you configure compute resources for running assets in tools\.
 *  [Jobs](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-projects.html?context=cdpaas&locale=en#jobs) are how you manage and schedule the running of assets in tools\.
 *  [Project documentation](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-projects.html?context=cdpaas&locale=en#docs) and notifications are how you stay informed about what's happening in the project\.
 *  [Asset storage](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-projects.html?context=cdpaas&locale=en#storage) is where project information and files are stored\.
 *  [Integrations](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-projects.html?context=cdpaas&locale=en#integ) are how you incorporate external tools\.

<!-- </ul> -->

You can customize projects to suit your goals\. You can change the contents of your project and almost all of its properties at any time\. However, you must make these choices when you create the project because you can't change them later:

<!-- <ul> -->

 *  The instance of IBM Cloud Object Storage to use for project storage\.

<!-- </ul> -->

You can view projects that you create and collaborate in by selecting **Projects > View all projects** in the navigation menu, or by viewing the **Projects** pane on the main page\.

## Collaboration in projects ##

As a project creator, you can add other collaborators and assign them roles that control which actions they can take\. You automatically have the **Admin** role in the project, and if you give other collaborators the **Admin** role, they can add collaborators too\. See [Adding collaborators](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/collaborate.html) and [Project collaborator roles](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/collaborator-permissions.html)\.

Tip: If appropriate, add at least one other user as a project administrator to ensure that someone is able to manage the project if you are unavailable\.

### Collaboration on assets ###

All collaborators work with the same copy of each asset\. Only one collaborator can edit an asset at a time\. While a collaborator is editing an asset in a tool, that asset is locked\. Other collaborators can view a locked asset, but not edit it\. See [Managing assets](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-assets.html)\.

## Data assets ##

You can add these types of data assets to projects:

<!-- <ul> -->

 *  Data assets from local files or the Samples
 *  Connections to cloud and on\-premises data sources
 *  Connected data assets from an existing connection asset that provide read\-only access to a table or file in an external data source
 *  Folder data assets to view the files within a folder in a file system

<!-- </ul> -->

Learn more about data assets:

<!-- <ul> -->

 *  [Connectors](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)
 *  [Adding data to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/add-data-project.html)
 *  [Data asset types and their properties](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/assets.html#data)
 *  [Searching for assets](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/search-assets.html)

<!-- </ul> -->

## Tools and their associated assets ##

When you run a tool, you create an asset that contains the information for a specific goal\. For example, when you run the Data Refinery tool, you create a Data Refinery flow asset that defines the set of ordered operations to run on a specific data asset\. Each tool has one or more types of associated assets that run in the tool\.

For a mapping of assets to the tools that you use to create them, see [Asset types and properties](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/assets.html)\.

## Environments ##

Environments control your compute resources\. An environment template specifies hardware and software resources to instantiate the environment runtimes that run your assets in tools\.

Some tools have an automatically selected environment template\. However, for other tools, you can choose between multiple environments\. When you create an asset in a tool, you assign an environment to it\. You can change the environment for an asset when you run it\.

Watson Studio includes a set of default environment templates that vary by coding language, tool, and compute engine type\. You can also create custom environment templates or add services that provide environment templates\.

The compute resources that you consume in a project are tracked\. Depending on your offering plan, you have a limit to your monthly compute resources or you pay for all compute resources\.

See [Environments](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/environments-parent.html)\.

## Jobs ##

A job is a single run of an asset in a tool with a specified environment runtime\. You can schedule one or repeating jobs, monitor, edit, stop, or cancel jobs\. See [Jobs](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/jobs.html)\.

## Asset storage ##

Each project has a dedicated, secure storage bucket that contains:

<!-- <ul> -->

 *  Data assets that you upload to the project as files\.
 *  Data assets from files that you copy from another workspace\.
 *  Files that you save to the project with a tool\.
 *  Files for assets that run in tools, such as notebooks\.
 *  Saved models\.
 *  The project readme file and internal project files\.

<!-- </ul> -->

When you create a project, you must select an instance of IBM Cloud Object Storage or create a new instance\. You cannot change the IBM Cloud Object Storage instance after you create the workspace\. See [Object storage](https://dataplatform.cloud.ibm.com/docs/content/wsj/admin/storage-options.html)\.

When you delete a project, its storage bucket is also deleted\.

## Integrations with external tools ##

Integrations provide a method to interact with tools that are external to the project\.

You can integrate with a Git repository to [publish notebooks](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/github-integration.html)\.

## Project documentation and notifications ##

While you create a project, you can add a short description to document the purpose or goal of the project\. You can edit the description later, on the project's **Settings** page\.

You can mark the project as sensitive\. When users open a project that is marked as sensitive, a notification is displayed stating that no data assets can be downloaded or exported from the project\.

The **Overview** page of a project contains a readme file where you can document the status or results of the project\. The readme file uses standard [Markdown formatting](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/markd-jupyter.html)\. Collaborators with the **Admin** or **Editor** role can edit the readme file\.

You can view recent asset activity in the **Assets** pane on the **Overview** page, and filter the assets by selecting **By you** or **By all** using the dropdown\. **By you** lists assets that you edited, ordered by most recent\. **By all** lists assets that are edited by others and also by you, ordered by most recent\.

All collaborators in a project are notified when a collaborator changes an asset\.

## Learn more ##

<!-- <ul> -->

 *  [Your sandbox project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/sandbox.html)
 *  [Creating a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/projects.html)
 *  [Administering a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/admin-project.html)
 *  [Adding collaborators](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/collaborate.html)
 *  [Managing assets](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/manage-assets.html)
 *  [Downloading data assets](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/download.html)
 *  [Environments](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/environments-parent.html)
 *  [Jobs](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/jobs.html)
 *  [Adding data](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/add-data-project.html)
 *  [Marking a project as sensitive](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/mark-sensitive.html)

<!-- </ul> -->

<!-- </article "role="article" "> -->