From af3956e1a9557a6ee1e0ffb729172a9cbe19674e Mon Sep 17 00:00:00 2001
From: David Rosa <rosatamsen@gmail.com>
Date: Tue, 28 Nov 2023 23:30:55 -0800
Subject: [PATCH] help: Document upgrade flow, billing, and sponsorship
 requests.

Documents how to upgrade to a paid plan, manage billing, and
apply for sponsorship.

Fixes #27946.
---
 help/zulip-cloud-billing.md                | 62 +++++++++++++++++++++-
 zerver/lib/markdown/help_relative_links.py |  6 +--
 zerver/lib/markdown/tabbed_sections.py     |  4 ++
 3 files changed, 67 insertions(+), 5 deletions(-)

diff --git a/help/zulip-cloud-billing.md b/help/zulip-cloud-billing.md
index f98cae89ce..59e300fa8c 100644
--- a/help/zulip-cloud-billing.md
+++ b/help/zulip-cloud-billing.md
@@ -1,8 +1,66 @@
 # Zulip Cloud billing
 
 This page answers some frequently asked questions about [Zulip Cloud plans and
-pricing](https://zulip.com/plans/). If you have any other questions, please don't hesitate to
-reach out at sales@zulip.com.
+pricing](https://zulip.com/plans/). If you have any other questions, please
+don't hesitate to reach out at [sales@zulip.com](mailto:sales@zulip.com).
+
+## Upgrade to a Zulip Cloud Standard or Plus plan
+
+{start_tabs}
+
+{tab|zulip-cloud-standard}
+
+{relative|gear|plans}
+
+1. Under the **Cloud Standard** pricing plan, click **Upgrade to Standard**.
+
+1. Select your preferred option from the **Payment schedule** dropdown.
+
+1. Click **Add card** to enter your payment details.
+
+1. Click **Purchase Zulip Cloud Standard**.
+
+{tab|zulip-cloud-plus}
+
+{relative|gear|plans}
+
+1. Under the **Cloud Plus** pricing plan, click **Contact sales**.
+
+{end_tabs}
+
+## Manage billing
+
+{start_tabs}
+
+{tab|desktop-web}
+
+{relative|gear|billing}
+
+{end_tabs}
+
+## Apply for sponsorship
+
+{start_tabs}
+
+{tab|request-sponsorship}
+
+1. Click on the **gear** (<i class="zulip-icon zulip-icon-gear"></i>) icon in
+   the upper right corner of the web or desktop app.
+
+1. Click the **Request sponsorship** link at the top of the gear menu.
+
+1. Fill out the requested information, and click **Submit**.
+
+{tab|request-education-pricing}
+
+1. Click on the **gear** (<i class="zulip-icon zulip-icon-gear"></i>) icon in
+   the upper right corner of the web or desktop app.
+
+1. Click the **Request education pricing** link at the top of the gear menu.
+
+1. Fill out the requested information, and click **Submit**.
+
+{end_tabs}
 
 ## Differences between Zulip Cloud plans
 
diff --git a/zerver/lib/markdown/help_relative_links.py b/zerver/lib/markdown/help_relative_links.py
index 8eafb41b63..b3a02ff72f 100644
--- a/zerver/lib/markdown/help_relative_links.py
+++ b/zerver/lib/markdown/help_relative_links.py
@@ -28,13 +28,13 @@ gear_info = {
     "integrations": ['<i class="fa fa-github"></i> Integrations', "/integrations/"],
     "stats": ['<i class="fa fa-bar-chart"></i> Usage statistics', "/stats"],
     "plans": ['<i class="fa fa-rocket"></i> Plans and pricing', "/plans/"],
-    "billing": ['<i class="fa fa-credit-card"></i> Billing', "/billing/"],
+    "billing": ['<i class="zulip-icon zulip-icon-credit-card"></i> Billing', "/billing/"],
     "about-zulip": ["About Zulip", "/#about-zulip"],
 }
 
 gear_instructions = """
-1. Click on the **gear** (<i class="fa fa-cog"></i>) icon in the upper
-   right corner of the web or desktop app.
+1. Click on the **gear** (<i class="zulip-icon zulip-icon-gear"></i>) icon in
+   the upper right corner of the web or desktop app.
 
 1. Select {item}.
 """
diff --git a/zerver/lib/markdown/tabbed_sections.py b/zerver/lib/markdown/tabbed_sections.py
index 69b9cc83a1..b8fac63c41 100644
--- a/zerver/lib/markdown/tabbed_sections.py
+++ b/zerver/lib/markdown/tabbed_sections.py
@@ -86,6 +86,10 @@ TAB_SECTION_LABELS = {
     "via-stream-settings": "Via stream settings",
     "default-subdomain": "Default subdomain",
     "custom-subdomain": "Custom subdomain",
+    "zulip-cloud-standard": "Zulip Cloud Standard",
+    "zulip-cloud-plus": "Zulip Cloud Plus",
+    "request-sponsorship": "Request sponsorship",
+    "request-education-pricing": "Request education pricing",
     "zulip-cloud": "Zulip Cloud",
     "self-hosting": "Self hosting",
     "okta": "Okta",