diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 3051670a2..68fbcedd7 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -81,3 +81,14 @@ jobs:
           user_name: github-actions[bot]
           user_email: 41898282+github-actions[bot]@users.noreply.github.com
           cname: docs.defang.io
+
+
+      - name: Notify Slack of Action Failures
+        uses: ravsamhq/notify-slack-action@2.5.0
+        if: ${{ always() && github.ref_name == 'main' }}
+        with:
+          status: ${{ job.status }}
+          notify_when: "failure"
+          notification_title: "{workflow} is failing"
+        env:
+          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_NOTIFIER_WEBHOOK_URL }}
diff --git a/docs/concepts/projects.md b/docs/concepts/projects.md
new file mode 100644
index 000000000..43ab41770
--- /dev/null
+++ b/docs/concepts/projects.md
@@ -0,0 +1,22 @@
+---
+title: Projects
+description: A _project_ refers to a cohesive collection of services which are defined and managed using a `compose.yml` file.
+sidebar_position: 200
+---
+
+# Projects
+
+A _project_ refers to a cohesive collection of services which are defined and managed using a `compose.yaml` file.
+
+## Project Names
+
+The _project name_ can be defined in the compose file with [the `name` property](https://docs.docker.com/compose/compose-file/04-version-and-name/#name-top-level-element), otherwise the base name of the project directory will be used.
+
+The project name may then be used when performing project-wide operations such as listing services, tailing logs, or deprovisioning. For example:
+```
+defang services --project-name <project-name>
+defang tail --project-name <project-name>
+defang compose down --project-name <project-name>
+```
+
+By default `defang` will use the project name from the `compose.yaml` file in the working directory. The [`--project-name` CLI flag](/docs/cli/defang) may be used when running `defang` from outside the working directory.