From 4681d7c743e35ea99afd2c82d0a8b28ef49b78b5 Mon Sep 17 00:00:00 2001
From: Heather Cloward <heathercloward@gmail.com>
Date: Thu, 30 Jan 2025 12:17:18 -0500
Subject: [PATCH] docs(all): adds info for finding org and project slugs to
 push-status command doc and removes broken links (#1868)

* docs(all): adds info for finding org and project slugs to push-status command doc and removes broken links

* docs(all): fixes prettier issues
---
 docs/commands/push-status.md | 25 +++++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/docs/commands/push-status.md b/docs/commands/push-status.md
index d0c6dcd09e..932c38cb29 100644
--- a/docs/commands/push-status.md
+++ b/docs/commands/push-status.md
@@ -27,14 +27,23 @@ REDOCLY_AUTHORIZATION=<api-key> redocly push-status <pushId> --organization <org
 
 ## Options
 
-| Option               | Type    | Description                                                                                                                     |
-| -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| pushId               | string  | **REQUIRED.** Identifier of the push you are tracking. Returned as result of the [`push`](./push.md) command.                   |
-| --organization, -o   | string  | **REQUIRED.** [Organization slug](https://redocly.com/docs/realm/setup/how-to/git-providers/gitlab-self-managed#find-org-slug). |
-| --project, -p        | string  | **REQUIRED.** [Project slug](https://redocly.com/docs/realm/setup/how-to/git-providers/gitlab-self-managed#find-org-slug).      |
-| --domain, -d         | string  | The domain that the `push` command pushed to. Default value is [https://app.cloud.redocly.com](https://app.cloud.redocly.com).  |
-| --wait               | boolean | Waits until the build is completed if it is in progress. Default value is `false`.                                              |
-| --max-execution-time | number  | Maximum wait time for build completion in seconds (used in conjunction with the `--wait` option). Default value is `600`.       |
+| Option               | Type    | Description                                                                                                                    |
+| -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| pushId               | string  | **REQUIRED.** Identifier of the push you are tracking. Returned as result of the [`push`](./push.md) command.                  |
+| --organization, -o   | string  | **REQUIRED.** [Organization slug](#find-org-slug).                                                                             |
+| --project, -p        | string  | **REQUIRED.** [Project slug](#find-org-slug).                                                                                  |
+| --domain, -d         | string  | The domain that the `push` command pushed to. Default value is [https://app.cloud.redocly.com](https://app.cloud.redocly.com). |
+| --wait               | boolean | Waits until the build is completed if it is in progress. Default value is `false`.                                             |
+| --max-execution-time | number  | Maximum wait time for build completion in seconds (used in conjunction with the `--wait` option). Default value is `600`.      |
+
+<details>
+<summary>How to find and copy the Reunite organization or project slugs<a id="find-org-slug"></a></summary>
+
+1. Log in to Reunite.
+2. Select your organization and project.
+3. Copy the value of the `{ORGANIZATION_SLUG}` or `{PROJECT_SLUG}` from the page URL in your browser, based on the following structure, `https://{REDOCLY_HOST}/org/{ORGANIZATION_SLUG}/project/{PROJECT_SLUG}`.
+
+</details>
 
 ## Examples