Feedback: Developer Basics - Revisiting CAP Theorem Assertions

Exalate commented:

Page: https://cockroachlabs.com/docs/v23.1/developer-basics.html

## What is the reason for your feedback?

Misleading information.

## Additional details

The page mentions that your product "satisfies the CAP Theorem," which, according to the traditional interpretation of the theorem, is theoretically impossible. As per the CAP Theorem, a distributed data system cannot simultaneously guarantee Consistency (C), Availability (A), and Partition Tolerance (P). The theorem forces a trade-off between consistency and availability when a network partition occurs.

I understand the intention may have been to communicate that your product skillfully manages these trade-offs or provides a well-rounded solution encompassing these aspects. Nevertheless, to avoid any misunderstanding, I recommend rephrasing this claim in a more nuanced manner. For example, you might say that your product "navigates the CAP theorem trade-offs effectively," or perhaps you could also go into detail with how you do it, or at least provide a link to a deeper explanation.

Jira Issue: DOC-8273