Skip to content

Update tidb-cloud-poc.md (#21336) #21411

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: release-8.5
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions tidb-cloud/tidb-cloud-poc.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,15 @@ To create a [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud

2. Refer to [Create a TiDB Cloud Dedicated Cluster](/tidb-cloud/create-tidb-cluster.md) to create a TiDB Cloud Dedicated cluster for the PoC.

> **Note:**
>
> Before creating a TiDB Cloud Dedicated cluster, you must add one of the following payment methods:
> - Add a credit card by following the on-screen instructions on the cluster creation page.
> - Contact the TiDB Cloud Support team to pay by wire transfer.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

low

To help users easily find how to contact the support team, it would be beneficial to link 'TiDB Cloud Support team' to the relevant support page. This improves the completeness of the documentation.1

Style Guide References

Suggested change
> - Contact the TiDB Cloud Support team to pay by wire transfer.
> - Contact the [TiDB Cloud Support team](/tidb-cloud/tidb-cloud-support.md) to pay by wire transfer.

Footnotes

  1. The style guide emphasizes making documentation complete and easy for users to understand. (link)

> - Sign up for TiDB Cloud through a cloud marketplace (AWS, Azure, or Google Cloud) to pay using your cloud provider account.
>
> Your PoC credits will automatically be used to offset eligible expenses incurred during the PoC period.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

low

For better readability and conciseness, you can rephrase this sentence to use active voice and simpler wording. This also aligns with the style guide's preference for avoiding passive voice and unnecessary words.12

Style Guide References

Suggested change
> Your PoC credits will automatically be used to offset eligible expenses incurred during the PoC period.
> Your PoC credits automatically cover eligible expenses during the PoC period.

Footnotes

  1. The style guide recommends avoiding unnecessary words and repetition to keep the documentation concise. (link)

  2. The style guide advises against overusing passive voice, suggesting active voice for clearer and more direct sentences (e.g., 'TiUP starts the cluster' instead of 'The cluster is started by TiUP'). (link)


Capacity planning is recommended for cluster sizing before you create a cluster. You can start with estimated numbers of TiDB, TiKV, or TiFlash nodes, and scale out the cluster later to meet performance requirements. You can find more details in the following documents or consult our support team.

- For more information about estimation practice, see [Size Your TiDB](/tidb-cloud/size-your-cluster.md).
Expand Down