PR test for Vale Review

[osfameron]

Preview URL: (fake)
https://preview.docs-test.couchbase.com/docs-capella-DOC-12670

You will need the Docs Team credentials on Confluence.

---

Some other content we want to keep

[tech-comm-team-couchbase]

Automated review comment from Vale and OpenAI using the gpt-4o-mini model:

Suggested change

	# This is an example
	# This Is An Example

Using these Vale rules:

• Couchbase.Headings (warning) - 'This is an example' should use title-style capitalization.

[simon-dew]

"This Is An Example" is not title case. According to Wikipedia

When using title case, all words are capitalized, except for minor words (typically articles, short prepositions, and some conjunctions)

So "This is an Example" would be correct. "This Is An Example" is not.

[osfameron]

Indeed. The docs bot is NOT trained on the style guide, so all it sees is "Couchbase.Headings (warning) - 'This is an example' should use title-style capitalization."

[tech-comm-team-couchbase]

Automated review comment from Vale and OpenAI using the gpt-4o-mini model:

Suggested change

	Note that this role does not grant the ability to back up or restore users.
	NOTE: This role does not grant the ability to back up or restore users.

Using these Vale rules:

• Couchbase.NoteThat (error) - Don't use 'note that.' Convert to an actual NOTE, or don't use it at all.

[tech-comm-team-couchbase]

Automated review comment from Vale and OpenAI using the gpt-4o-mini model:

Suggested change

	This page is about what is so good about couchbase server. And about couchbase capella.
	This page is about what's so good about Couchbase Server.
	And about Couchbase Capella.

Using these Vale rules:

• Couchbase.Contractions (error) - Use 'what's' instead of 'what is'.
• Vale.Terms (error) - Use 'Couchbase Server' instead of 'couchbase server'.
• Couchbase.VentilatedProse (warning) - Use ventilated prose. Start every sentence on a new line.
• Vale.Terms (error) - Use 'Couchbase' instead of 'couchbase'.
• Vale.Terms (error) - Use 'Capella' instead of 'capella'.

[tech-comm-team-couchbase]

Automated review comment from Vale and OpenAI using the gpt-4o-mini model:

Suggested change

	3+^| Role: Backup Full Admin (`backup_admin`)
	3+^| Role: Backup Full Admin (`backup_admin`)

Using these Vale rules:

• Couchbase.RepeatedSpace (error) - Did you mean to add extra spaces?

[tech-comm-team-couchbase]

Automated review comment from Vale and OpenAI using the gpt-4o-mini model:

Suggested change

	** Users that are explicitly registered on Couchbase Server as _external_; as supported either by _LDAP_, _Security Assertion Markup Language (SAML)_, or _PAM_.
	** Users that are explicitly registered on Couchbase Server as external, as supported either by LDAP, Security Assertion Markup Language (SAML), or PAM.

Using these Vale rules:

• Couchbase.Italics (error) - Don't use italics. Find another way to add emphasis.
• Couchbase.Semi-Colons (warning) - Try to avoid using a semi-colon. Follow the style guide guidance.

[tech-comm-team-couchbase]

Automated review comment from Vale and OpenAI using the gpt-4o-mini model:

Suggested change

	It's important not to access the database directly.
	It's important not to use the database directly.

Using these Vale rules:

• Google.WordList (warning) - Use 'see', 'edit', 'find', 'use', or 'view' instead of 'to access'.

[tech-comm-team-couchbase]

Automated review comment from Vale and OpenAI using the gpt-4o-mini model:

Suggested change

	Database access is great!
	Database access is great.

Using these Vale rules:

• Google.Exclamation (error) - Don't use exclamation points in text.

[tech-comm-team-couchbase]

Automated review comment from Vale and OpenAI using the gpt-4o-mini model:

Suggested change

	Role based access controls are awesome!
	Role based access controls are awesome.

Using these Vale rules:

• Google.Exclamation (error) - Don't use exclamation points in text.

[tech-comm-team-couchbase]

Automated review comment from Vale and OpenAI using the gpt-4o-mini model:

Suggested change

	NOTE: We recommend keeping residentRatio above 10 to avoid issues like index build failures.
	NOTE: It's recommended to keep residentRatio later 10 to avoid issues like index build failures.

Using these Vale rules:

• Google.We (warning) - Try to avoid using first-person plural like 'We'.
• Vale.Spelling (error) - Did you really mean 'residentRatio'?
• Couchbase.DirectionalLanguage (warning) - Avoid directional language like 'above'.
• Google.WordList (warning) - Use 'preceding' or 'later' instead of 'above'.