<a id="how-index"></a>

# How-to guides

<!-- @artefact workshop -->

These articles
cover the needs and corner cases
that arise when you use **Workshop** and **SDKcraft**.

<a id="how-use-workshops"></a>

## Customize workshops

Daily **Workshop** usage may involve multiple one-off scenarios:
moving projects within the filesystem, adding custom actions,
or running multiple workshops side by side:

* [Customize workshops](https://ubuntu.com/workshop/docs//how-to/customize-workshops/index.md)
  * [Add actions to workshops](https://ubuntu.com/workshop/docs//how-to/customize-workshops/add-actions.md)
  * [Add mounts](https://ubuntu.com/workshop/docs//how-to/customize-workshops/add-mounts.md)
  * [Forward ports](https://ubuntu.com/workshop/docs//how-to/customize-workshops/forward-ports.md)
  * [Move projects around](https://ubuntu.com/workshop/docs//how-to/customize-workshops/move-projects.md)
  * [Use multiple workshops](https://ubuntu.com/workshop/docs//how-to/customize-workshops/use-multiple-workshops.md)

<a id="how-develop-workshops"></a>

## Develop with workshops

**Workshop** integrates with developer tooling;
AI agents, IDEs, version control, and CI/CD workflows all work inside a workshop:

* [Develop with workshops](https://ubuntu.com/workshop/docs//how-to/develop-with-workshops/index.md)
  * [Connect VS Code to a workshop](https://ubuntu.com/workshop/docs//how-to/develop-with-workshops/connect-vscode.md)
  * [Run JetBrains Gateway in a workshop](https://ubuntu.com/workshop/docs//how-to/develop-with-workshops/run-jetbrains-gateway.md)
  * [Run JupyterLab in your browser](https://ubuntu.com/workshop/docs//how-to/develop-with-workshops/run-jupyterlab-in-browser.md)
  * [Manage Python environments](https://ubuntu.com/workshop/docs//how-to/develop-with-workshops/manage-python-environments.md)
  * [Run GitHub Actions locally](https://ubuntu.com/workshop/docs//how-to/develop-with-workshops/run-github-actions-locally.md)
  * [Run workshops in GitHub Actions](https://ubuntu.com/workshop/docs//how-to/develop-with-workshops/run-workshops-in-github-actions.md)
  * [Use workshops with AI agents](https://ubuntu.com/workshop/docs//how-to/develop-with-workshops/use-workshops-with-ai-agents.md)
  * [Use workshops with Git](https://ubuntu.com/workshop/docs//how-to/develop-with-workshops/use-git.md)

## Develop SDKs

<!-- @artefact SDK -->

These guides cover the work of authoring an SDK with **SDKcraft**
and publishing it to the SDK Store:

* [Develop SDKs](https://ubuntu.com/workshop/docs//how-to/develop-sdks/index.md)
  * [Build an SDK](https://ubuntu.com/workshop/docs//how-to/develop-sdks/build-an-sdk.md)
  * [Publish an SDK](https://ubuntu.com/workshop/docs//how-to/develop-sdks/publish-an-sdk.md)

<a id="how-fix-workshops"></a>

## Fix workshops

Troubleshooting covers issues with running workshops
and with the **Workshop** installation itself:

* [Fix workshops](https://ubuntu.com/workshop/docs//how-to/fix-workshops/index.md)
  * [Debug issues in workshops](https://ubuntu.com/workshop/docs//how-to/fix-workshops/debug-issues.md)
  * [Resolve plug conflicts](https://ubuntu.com/workshop/docs//how-to/fix-workshops/resolve-plug-conflicts.md)
  * [Fix the installation](https://ubuntu.com/workshop/docs//how-to/fix-workshops/fix-installation.md)
  * [Purge workshops](https://ubuntu.com/workshop/docs//how-to/fix-workshops/purge.md)