As an admin, organizer, or content owner (which here equates to creator of or maintainer of existing codelab content), you have a technical tutorial you want to import to PlusPlus as a codelab. This can be a new codelab or an updated version of an existing one.
Please note that if this setting is toggled on in global settings here: https://CUSTOMER_INSTANCE/plusplus.app/a/system-settings/content - regular users cannot create/import new codelabs:
Import the tutorial using the steps below.
But first, make sure you have codelabs enabled in your instance of PlusPlus.
Prepare your codelab content in one of the following ways:
Learn more about authoring Google Codelabs.
In your PlusPlus Catalog, click New and select Codelab from the menu.
Note that you may need to enable codelabs first at Settings > Site > Supported content types.
If you want to import a new version of an existing codelab, access the codelab in PlusPlus, open the context menu (button with three dots), and select Import new version.
The Import new codelab (or Import new codelab version) dialog opens.
For a Markdown (ZIP) codelab, click Select a ZIP file.
Your file explorer opens.
For a codelab authored in Google Docs, click Select a Google Doc.
The Select a file dialog opens for Google Docs. (You may have to sign in with your Google account first.)
Select the codelab file (zipped or Google Doc) you want to import.
A dialog opens showing import progress until completion, and you are navigated to the Edit Codelab page for the new codelab. (Or, if updating a codelab with a new version, you are navigated back to the codelab’s landing page, and the process is complete).
Update the codelab as needed.
Note that the system automatically attempts to set the codelab's name, description, duration, and tags, based on metadata included in the codelab file.
The person who imports the file is added as the codelab Maintainer by default.
You can also set the codelab as inline if you only want it to be visible in tracks to which it is added.
The new codelab is added to the Catalog and is discoverable for engineers.
Google Drive integration
To turn on the Google Drive integration, go to Settings > Integrations > Storage and turn on Enable Google Drive integration. Be sure to Save your settings, too.
Learn more about integrating PlusPlus with Google Workspace.
Zipping your codelab files
The zipped Google Codelab-formatted Markdown file you create should contain the codelab Markdown (.md) file, plus any assets, but avoid other files or folder structures. The import tool picks up the first .md file in the zip file that is not README.md.
The formatting for authoring in Google Codelabs is familiar to engineers, and PlusPlus can use the metadata defined in a Markdown file to build out codelab details upon import.
The option to import codelabs authored in Google Docs does not require the zipping process.
Are users already in a codelab able to see the updated version?
Once learners launch a codelab, they remain on the same version of the codelab until completion, even if you add a new version of the codelab while they are still engaging it. To engage the new version, learners already in the codelab must drop their assignment to the codelab and launch again. However, we are soon to release a feature that allows learners to choose whether to Relaunch the codelab with the latest version or to Continue their progress with the previous version.
Managing and tracking codelab assignments
You can see who has been assigned to a codelab and how far they've gotten through it, and you can update their assignment in various ways. Learn more.