diff --git a/docs/cypress-testing-library/intro.md b/docs/cypress-testing-library/intro.md
index abbc9a4e6..2bc1d1228 100644
--- a/docs/cypress-testing-library/intro.md
+++ b/docs/cypress-testing-library/intro.md
@@ -27,9 +27,9 @@ and `queryAllBy` commands off the global `cy` object.
 [See the `DOM Testing Library` docs for reference](https://testing-library.com/docs/dom-testing-library/api-queries).
 
 > Note: the `get*` queries are not supported because for reasonable Cypress tests you
-> need retryability and `find*` queries already support that. The reason the `query*`
-> variants are supported is to allow you to assert that elements do _not_ appear on
-> the screen.
+> need retryability and `find*` queries already support that. `query*` queries are no longer
+> necessary since v5 and will be removed in v6. `find*` fully support built-in Cypress
+> assertions (removes the only use-case for `query*`).
 
 ## With TypeScript
 
@@ -53,12 +53,12 @@ To show some simple examples (from
 
 ```javascript
 cy.findAllByText('Jackie Chan').click()
-cy.queryByText('Button Text').should('exist')
-cy.queryByText('Non-existing Button Text').should('not.exist')
-cy.queryByLabelText('Label text', {timeout: 7000}).should('exist')
-cy.get('form').within(() => {
-  cy.findByText('Button Text').should('exist')
-})
+cy.findByText('Button Text').should('exist')
+cy.findByText('Non-existing Button Text').should('not.exist')
+cy.findByLabelText('Label text', {timeout: 7000}).should('exist')
+
+// findAllByText _inside_ a form element
+cy.get('form').findByText('Button Text').should('exist')
 cy.get('form').then(subject => {
   cy.findByText('Button Text', {container: subject}).should('exist')
 })