Workspace projects are authored using a combination of DataCamp's Workspace and Teach Editor products.

For an overview of the Teach Editor for Workspace projects please refer to this article.

Setting up an integration

If your project involves the use of a SQL database, please contact the Content team for support in setting this up.

Developing a Workspace

To develop a Workspace, you need to navigate to https://app.datacamp.com/workspace/overview.

Once here, you can create a new Workspace using the green "Create workspace" button on the left hand-side:

This will open a pop-up window, in which you can add a Workspace name, which should be the name of your project. You should leave Workspace Visibility set to "Public" and Language set to "Python + SQL" if creating a Python or SQL project, or "R + SQL" if creating a R project. If you are using an existing integration such as a SQL database, you can select it from the Integration dropdown menu. Lastly, select the Create Workspace button.

This will create a new Workspace where you can author the project. You need to complete the following steps:

Upload files

Select the "Browse and upload files" tab on the left-hand side.

Either select the browse files link or drag and drop your file(s) into the area below.

(Optional) If you plan to display an image in your notebook then please also upload the file during this step.

Add Context

Select the Add Text button.

Select the Move Up button to the right of the text cell to move it above the code cell.

Author your Context to describe and motivate the project using Markdown. Please see this article for an example of Context within a notebook.

Add Sample Code

Add code to the existing code cell. This will appear when learners start the project, so typically imports required libraries and possibly reads in data as a variable.

Exporting your Workspace

Once you have finished authoring your Workspace, click on File in the top-left, then "Download workspace".

This will download a zipped folder containing your notebook and all uploaded files.
- Please note that your Workspace must contain code in a notebook rather than a script.
Rename the zipped folder to template.zip.

Uploading your Workspace to GitHub

Your project lives in a GitHub repo that will be created by the Content team. During development, all edits you make to your project will be in the development branch (please do not navigate to or make any edits to the master branch, either within the Teach Editor or in GitHub).

To add your Workspace into the Teach Editor you need to navigate to your project's GitHub repo and ensure you are in the development branch.
Once there, select Add file then choose Upload files from the dropdown menu.

Either click on "choose your files" or drag and drop template.zip into the selected area.
Add a commit message.
Commit changes.

Developing a Workspace Project at DataCamp