docs: document cloud sign in methods, usage and add-on changes (#14333)

www/apps/cloud/app/billing/page.mdx

@@ -93,7 +93,19 @@ For example, you may see a note saying "Inviting an additional member adds $X to
 
 ### Where can I view my add-ons?
 
-You can view your add-on charges in the [Invoices](#view-billing-history-and-invoices) section of your organization's settings. The add-on charges will be included in the "Upcoming Payments" table.
+To view your organization's add-ons:
+
+1. [Open the organization's settings](../organizations/page.mdx#view-organization-settings).
+2. Click on "Add-ons" from the sidebar.
+
+This will show a list of all the add-ons that Cloud provides. For each add-on, you can see:
+
+1. **Usage**: The number of resources you're currently using for that add-on with respect to your plan's limits.
+2. **Add-ons**: The number of additional resources you've purchased for that add-on. For example, if your plan allows `5` user seats and you have `7` users, you've purchased `2` additional user seats as add-ons.
+3. **Renewal charge**: The amount you'll be charged to renew your add-ons at the start of each billing cycle.
+3. **Pending charge**: The amount you owe for add-ons added during the current billing cycle. For example, if you purchased an additional user seat halfway through the month, you'll see a pro-rated charge for that seat here.
+
+![Add-ons section in the Add-ons settings](https://res.cloudinary.com/dza7lstvk/image/upload/v1765975143/Cloud/CleanShot_2025-12-17_at_14.37.35_2x_kkznru.png)
 
 ---
 

www/apps/cloud/app/organizations/page.mdx

@@ -201,19 +201,6 @@ To remove a member from your organization:
 
 ---
 
-## Manage Profile Details
-
-To edit your profile's details:
-
-1. Click on your name and avatar at the top right of the Cloud dashboard.
-2. Choose "Settings" from the dropdown.
-3. This will open the Profile settings tab in the Organization Settings. You can edit your first and last name and email address.
-4. Once you're done making changes, click the "Update profile" button.
-
-![Window showing the profile settings with the Profile tab selected](https://res.cloudinary.com/dza7lstvk/image/upload/v1749735037/Cloud/CleanShot_2025-06-12_at_16.30.12_2x_bxz00e.png)
-
----
-
 ## Manage Billing Details
 
 Refer to the [Billing](../billing/page.mdx) guide to learn how to manage your organization's billing details, including payment methods, invoices, and usage.

www/apps/cloud/app/usage/page.mdx

@@ -42,13 +42,36 @@ To learn how your Flex Usage is billed, refer to the [Billing](../billing/page.m
 
 ### Monitor Flex Usage
 
-You can view additional Flex Usage for each resource and its charge in the [usage table](#view-usage-on-cloud). The table has the following columns useful for monitoring Flex Usage:
+You can view additional Flex Usage for each resource and its charge in the [usage table](#view-usage-on-cloud). For each resource, the table has the following columns useful for monitoring Flex Usage:
 
 - **Flex**: The amount of usage beyond your plan limits. For example, the additional data transfer amount.
 - **Charge**: The cost associated with the Flex Usage.
 
 If you have Flex Usage, you can also see the flex charges visualized in the chart above the table.
 
+### Usage Chart Per Resource
+
+In the "Billable metrics" section of the Usage settings, you can view a chart for each resource showing your usage over time with forcasted usage. For example, you can view the usage chart for data transfer, Compute, object storage, etc...
+
+#### Usage Chart Types
+
+At the type of the "Billable metrics" section, you can find a "Cumulative" toggle. When enabled, the charts will display cumulative usage over time. When disabled, the charts will show daily usage.
+
+Cumulative usage helps you understand the total usage up to a specific date, while daily usage provides insights into your usage patterns on a day-to-day basis.
+
+![Cumulative usage toggle in the Billable metrics section](https://res.cloudinary.com/dza7lstvk/image/upload/v1765976513/Cloud/CleanShot_2025-12-17_at_15.01.07_2x_aimjwh.png)
+
+#### Understanding the Charts
+
+In each chart, there are two line types:
+
+1. Green lines: Represent your actual usage for the resource over time. This is the usage that has already occurred.
+2. Grey lines: Represent the forecasted usage for the resource. This is an estimate of your future usage based on historical data.
+
+There's also a horizontal orange dashed line indicating your plan's usage limit for that resource. If your actual usage (green line) exceeds this limit, the excess is considered Flex Usage.
+
+![Usage chart showing actual and forecasted usage with plan limit](https://res.cloudinary.com/dza7lstvk/image/upload/v1765976514/Cloud/CleanShot_2025-12-17_at_15.01.21_2x_upehmd.png)
+
 ---
 
 ## Download Cloud Usage Report

www/apps/cloud/app/user/page.mdx

@@ -0,0 +1,42 @@
+export const metadata = {
+  title: `Manage User Account on Cloud`,
+}
+
+# {metadata.title}
+
+In this guide, you'll learn how to manage your user account on Cloud.
+
+## Manage Profile Details
+
+You can edit your profile details such as your name and email address from the Profile settings in the Organization Settings.
+
+To edit your profile's details:
+
+1. Click on your name and avatar at the top right of the Cloud dashboard.
+2. Choose "Account settings" from the dropdown.
+3. This will open the Profile settings tab in the Organization Settings. You can edit your first and last name and email address.
+4. Once you're done making changes, click the "Update profile" button.
+
+![The profile settings with the Profile tab selected](https://res.cloudinary.com/dza7lstvk/image/upload/v1749735037/Cloud/CleanShot_2025-06-12_at_16.30.12_2x_bxz00e.png)
+
+---
+
+## Manage Sign-In Methods
+
+Cloud supports sign-in via email and password, and via GitHub.
+
+An email and GitHub accounts can be connected to a single Cloud user account. So, if you have multiple accounts, you can change the sign-in method for any of them to use either email/password or GitHub.
+
+To manage your sign-in methods:
+
+1. [Open the organization's settings](../organizations/page.mdx#view-organization-settings).
+2. Click on the Authentication setting tab from the sidebar.
+
+Under the "Sign-in methods" section, you can connect or disconnect your email and GitHub accounts:
+
+1. If you choose to connect an email account, you'll need to set a password for your Cloud account.
+2. If you choose to connect a GitHub account, you'll be redirected to GitHub to authorize the connection.
+
+If you disconnect any sign-in method, you won't be able to use that method to sign in to your Cloud account anymore.
+
+![The Authentication settings with the Sign-in methods section](https://res.cloudinary.com/dza7lstvk/image/upload/v1765975168/Cloud/CleanShot_2025-12-17_at_14.05.59_2x_d5wvbx.png)

www/apps/cloud/generated/edit-dates.mjs

@@ -4,7 +4,7 @@ export const generatedEditDates = {
   "app/projects/page.mdx": "2025-11-20T09:48:32.899Z",
   "app/environments/page.mdx": "2025-10-15T15:25:09.940Z",
   "app/deployments/page.mdx": "2025-10-17T14:40:07.793Z",
-  "app/organizations/page.mdx": "2025-10-02T11:31:07.315Z",
+  "app/organizations/page.mdx": "2025-12-17T11:56:48.669Z",
   "app/notifications/page.mdx": "2025-10-15T15:25:33.672Z",
   "app/database/page.mdx": "2025-10-20T15:47:46.364Z",
   "app/redis/page.mdx": "2025-10-15T15:22:34.997Z",
@@ -17,8 +17,8 @@ export const generatedEditDates = {
   "app/environments/long-lived/page.mdx": "2025-10-15T15:27:08.743Z",
   "app/environments/preview/page.mdx": "2025-11-03T12:50:29.841Z",
   "app/faq/page.mdx": "2025-10-08T14:43:21.930Z",
-  "app/billing/page.mdx": "2025-11-20T09:46:30.191Z",
+  "app/billing/page.mdx": "2025-12-17T12:39:37.397Z",
-  "app/usage/page.mdx": "2025-11-03T12:45:13.760Z",
+  "app/usage/page.mdx": "2025-12-17T13:02:15.554Z",
   "app/billing/manage/page.mdx": "2025-10-08T14:40:23.629Z",
   "app/pricing/page.mdx": "2025-09-05T10:31:59.059Z",
   "app/sign-up/page.mdx": "2025-11-04T06:51:07.747Z",
@@ -27,5 +27,6 @@ export const generatedEditDates = {
   "app/cache/page.mdx": "2025-11-12T14:37:24.809Z",
   "app/deployments/troubleshooting/page.mdx": "2025-10-17T14:44:22.894Z",
   "app/emails/page.mdx": "2025-11-26T11:07:58.083Z",
-  "app/emails/react-email/page.mdx": "2025-11-12T15:41:56.365Z"
+  "app/emails/react-email/page.mdx": "2025-11-12T15:41:56.365Z",
+  "app/user/page.mdx": "2025-12-17T12:03:18.968Z"
 }

www/apps/cloud/generated/sidebar.mjs

@@ -116,6 +116,14 @@ export const generatedSidebars = [
                 "children": []
               }
             ]
+          },
+          {
+            "loaded": true,
+            "isPathHref": true,
+            "type": "link",
+            "title": "Account",
+            "path": "/user",
+            "children": []
           }
         ]
       },

www/apps/cloud/sidebar.mjs

@@ -80,6 +80,11 @@ export const sidebar = [
               },
             ],
           },
+          {
+            type: "link",
+            title: "Account",
+            path: "/user",
+          },
         ],
       },
       {