Skip to content
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

chore: change wording and move periods outside of links #1703

Merged
merged 26 commits into from
Nov 18, 2024
Merged
Show file tree
Hide file tree
Changes from 7 commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
0f845e1
for more details -> for more information
victoriaxyz Nov 13, 2024
bb40128
check out -> see
victoriaxyz Nov 13, 2024
782ecce
remove our
victoriaxyz Nov 13, 2024
f3de5bb
move period out of link
victoriaxyz Nov 13, 2024
93b254c
move "the" out of link
victoriaxyz Nov 13, 2024
3bcb892
remove please and replace "reach out" with "contact"
victoriaxyz Nov 13, 2024
d5a9e65
lint
victoriaxyz Nov 13, 2024
2427fd4
merge conflicts
victoriaxyz Nov 14, 2024
edae0c9
Merge branch 'main' into vi/chore/edits
alexisintech Nov 14, 2024
be5d6fc
Update docs/advanced-usage/using-proxies.mdx
victoriaxyz Nov 14, 2024
be6082a
Update styleguides/STYLEGUIDE.md
victoriaxyz Nov 14, 2024
347d9cb
Update CONTRIBUTING.md
victoriaxyz Nov 14, 2024
04ec13f
Apply suggestions from code review
victoriaxyz Nov 14, 2024
91ad229
Update styleguides/STYLEGUIDE.md
victoriaxyz Nov 14, 2024
bd79510
Merge branch 'main' into vi/chore/edits
victoriaxyz Nov 14, 2024
3ed549c
Set up your application guide -> setup guide
victoriaxyz Nov 14, 2024
54fb35b
fix
victoriaxyz Nov 15, 2024
c1f9545
Merge branch 'main' into vi/chore/edits
victoriaxyz Nov 15, 2024
d216df3
Merge branch 'main' into vi/chore/edits
victoriaxyz Nov 18, 2024
48b7df2
Merge branch 'main' into vi/chore/edits
victoriaxyz Nov 18, 2024
427f075
set up your application guide --> setup guide
alexisintech Nov 18, 2024
2d88707
Update docs/integrations/databases/firebase.mdx
alexisintech Nov 18, 2024
26907a0
Update docs/integrations/webhooks/overview.mdx
alexisintech Nov 18, 2024
57b45db
Update docs/quickstarts/ios.mdx
alexisintech Nov 18, 2024
6099506
Update docs/references/sdk/fullstack.mdx
alexisintech Nov 18, 2024
206821d
remove please
alexisintech Nov 18, 2024
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
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Contributing to Clerk's documentation

Thanks for being willing to contribute to [Clerk's documentation](https://clerk.com/docs)! This document outlines how to effectively contribute to the documentation content located in this repository. Check out the [style guide](./styleguides/styleguide.md) for more information on our guidelines for writing content.
Thanks for being willing to contribute to [Clerk's documentation](https://clerk.com/docs)! This document outlines how to effectively contribute to the documentation content located in this repository. See the [style guide](./styleguides/styleguide.md) for more information on our guidelines for writing content.

## Written in MDX

Expand Down Expand Up @@ -515,7 +515,7 @@ pnpm add @clerk/nextjs

The image below shows what this example looks like once rendered.

![An example of a <CodeBlockTabs /> component with three tabs options for 'npm', 'yarn', and 'pnpm'. Each tab shows a code example of how to install the @clerk/nextjs package.](/.github/media/code-block-tabs.png)
![An example of a <CodeBlockTabs /> component with three tabs options for 'npm', 'yarn', and 'pnpm'. Each tab shows a code example of how to install the @clerk/nextjs package](/.github/media/code-block-tabs.png).
victoriaxyz marked this conversation as resolved.
Show resolved Hide resolved

### `<Tabs />`

Expand Down
2 changes: 1 addition & 1 deletion docs/advanced-usage/clerk-idp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Clerk can be configured as an identity provider to facilitate Single Sign-On (SS

## When should you use Clerk as an OAuth provider?

You can use Clerk as an OAuth provider if you want your users to sign in to a third party site or a tool using their credentials from your application. **This is not the same as supporting an OAuth provider, such as Google, in your application. If you want your users to be able to sign in to your application with an OAuth provider, see [the dedicated guide](/docs/authentication/social-connections/oauth#configuration).**
You can use Clerk as an OAuth provider if you want your users to sign in to a third party site or a tool using their credentials from your application. **This is not the same as supporting an OAuth provider, such as Google, in your application. If you want your users to be able to sign in to your application with an OAuth provider, see the [dedicated guide](/docs/authentication/social-connections/oauth#configuration).**

## How it works

Expand Down
4 changes: 2 additions & 2 deletions docs/advanced-usage/satellite-domains.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ To access authentication state from a satellite domain, users will be transparen
When building your sign-in flow, you must configure it to run within your primary application, e.g. on `/sign-in`.

> [!NOTE]
> For more information about creating your application, check out Clerk's [detailed guide](/docs/quickstarts/setup-clerk).
> For more information about creating your application, see the [detailed guide](/docs/quickstarts/setup-clerk).

### Add your first satellite domain

Expand Down Expand Up @@ -407,4 +407,4 @@ To access authentication state from a satellite domain, users will be transparen
You can repeat this process and create as many satellite applications as you need.
</Steps>

If you have any questions about satellite domains, or you're having any trouble setting this up, please contact [[email protected]](mailto:[email protected])
If you have any questions about satellite domains, or you're having any trouble setting this up, contact [[email protected]](mailto:[email protected])
6 changes: 3 additions & 3 deletions docs/advanced-usage/using-proxies.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ When using a proxy, all requests to the Frontend API will be made through your d
To get started, you need to create an application from the [Clerk Dashboard](https://dashboard.clerk.com/). Once you create an instance via the Clerk Dashboard, you will be prompted to choose a domain. For the purposes of this guide, the domain will be `app.dev`.

> [!NOTE]
> For more information on creating a Clerk application, check out our [Set up your application guide](/docs/quickstarts/setup-clerk).
> For more information on creating a Clerk application, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
victoriaxyz marked this conversation as resolved.
Show resolved Hide resolved

### Configure your proxy server

Expand Down Expand Up @@ -146,7 +146,7 @@ When using a proxy, all requests to the Frontend API will be made through your d
</Tabs>

> [!NOTE]
> Every proxy configuration will be different and we're here to help. Please [reach out](/contact/support){{ target: '_blank' }} if there's a specific use-case you're looking to solve.
> Every proxy configuration will be different and we're here to help. [Contact support](/contact/support){{ target: '_blank' }} if there's a specific use-case you're looking to solve.

### Enable proxying

Expand Down Expand Up @@ -325,4 +325,4 @@ When using a proxy, all requests to the Frontend API will be made through your d
Your application should now be able to access Clerk's Frontend API from your proxy!
</Steps>

If you have any questions about proxying, or you're having any trouble setting this up, please contact [[email protected]](mailto:[email protected]).
If you have any questions about proxying, or you're having any trouble setting this up, contact [[email protected]](mailto:[email protected]).
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ It will be useful to take a look at the following terms as they will reappear in

### Revolvapp WYSIWYG email editor plugin

The email editor uses the [Revolvapp](https://imperavi.com/redactor/legacy/revolvapp) email template editor plugin by Imperavi. To acquaint yourself with the template markup syntax, please consult the corresponding [documentation page](https://imperavi.com/redactor/legacy/revolvapp/docs/syntax/quick-start).
The email editor uses the [Revolvapp](https://imperavi.com/redactor/legacy/revolvapp) email template editor plugin by Imperavi. To acquaint yourself with the template markup syntax, consult the corresponding [documentation page](https://imperavi.com/redactor/legacy/revolvapp/docs/syntax/quick-start).
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
The email editor uses the [Revolvapp](https://imperavi.com/redactor/legacy/revolvapp) email template editor plugin by Imperavi. To acquaint yourself with the template markup syntax, consult the corresponding [documentation page](https://imperavi.com/redactor/legacy/revolvapp/docs/syntax/quick-start).
The email editor uses the [Revolvapp](https://imperavi.com/redactor/legacy/revolvapp) email template editor plugin by Imperavi. To acquaint yourself with the template markup syntax, consult [Imperavi's docs](https://imperavi.com/redactor/legacy/revolvapp/docs/syntax/quick-start).


As you will see, the template markup is an HTML-like language and each type of node supports its own set of attributes which control its behavior. A lot of the attributes are borrowed from HTML itself.

Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/configuration/session-options.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -63,4 +63,4 @@ There are two main ways to add the multi-session feature to your application:

Session tokens are JWTs that contain a set of [default claims](/docs/backend-requests/resources/session-tokens) required by Clerk. You can customize these tokens by providing additional claims of your own.

To learn how to customize session tokens, check out our [Customize your session token](/docs/backend-requests/making/custom-session-token) guide.
To learn how to customize session tokens, see the [Customize your session token](/docs/backend-requests/making/custom-session-token) guide.
victoriaxyz marked this conversation as resolved.
Show resolved Hide resolved
Original file line number Diff line number Diff line change
Expand Up @@ -208,4 +208,4 @@ To reset a user's MFA:

## Restrictions

Clerk provides a set of restriction options designed to provide you with enhanced control over who can gain access to your application. Restrictions can limit sign-ups or prevent accounts with specific identifiers, such as email addresses, phone numbers, and even entire domains, from accessing your application. [Learn more about restrictions.](/docs/authentication/configuration/restrictions)
Clerk provides a set of restriction options designed to provide you with enhanced control over who can gain access to your application. Restrictions can limit sign-ups or prevent accounts with specific identifiers, such as email addresses, phone numbers, and even entire domains, from accessing your application. [Learn more about restrictions](/docs/authentication/configuration/restrictions).
2 changes: 1 addition & 1 deletion docs/authentication/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,4 +9,4 @@ Clerk supports multiple authentication strategies so that you can implement the

Clerk's configuration settings affect how the users of your application can [sign up and sign in](/docs/authentication/configuration/sign-up-sign-in-options) and which properties are editable via their user profile. You can also manage [user sessions](/docs/authentication/configuration/session-options), [control who gets access](/docs/authentication/configuration/restrictions) to your application, and [customize the email & SMS messages](/docs/authentication/configuration/email-sms-templates) that are sent by Clerk during authentication flows. All of these settings can be found under the **User & Authentication** section in the [Clerk Dashboard](https://dashboard.clerk.com/).

Check out our detailed guide for information on [how to set up your application](/docs/quickstarts/setup-clerk).
See the detailed guide for information on [how to set up your application](/docs/quickstarts/setup-clerk).
victoriaxyz marked this conversation as resolved.
Show resolved Hide resolved
2 changes: 1 addition & 1 deletion docs/authentication/saml/account-linking.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ In the following sections, we'll look at the different scenarios that can occur
> [!NOTE]
> Email addresses from SAML providers are considered verified by default.

![Flow chart of the SAML SSO account linking process in various scenarios.](/docs/images/authentication/account-linking-flow-saml.webp)
![Flow chart of the SAML SSO account linking process in various scenarios](/docs/images/authentication/account-linking-flow-saml.webp).
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
![Flow chart of the SAML SSO account linking process in various scenarios](/docs/images/authentication/account-linking-flow-saml.webp).
![Flow chart of the SAML SSO account linking process in various scenarios.](/docs/images/authentication/account-linking-flow-saml.webp)


### Email is verified in Clerk

Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/saml/custom-provider.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -101,7 +101,7 @@ Clerk supports Enterprise SSO via the SAML protocol, enabling you to create auth

For example, say you were using Google as your IdP. Google users have the "Phone number" attribute. Clerk does not have a direct mapping for this attribute, as you can see in the Clerk Dashboard in the **Attribute mapping** section. Instead, in the Google dashboard, you would map Google's "Phone number" claim to `public_metadata_phone_number`. Then, in Clerk, the value for the user's phone number would be saved in the user's `User.publicMetadata` under the key `phone_number`.

[Learn more about how to access the metadata from our APIs.](/docs/users/metadata)
[Learn more about how to access the metadata from our APIs](/docs/users/metadata).
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
[Learn more about how to access the metadata from our APIs](/docs/users/metadata).
Learn more about [how to access the metadata from our APIs](/docs/users/metadata).


### Activate your SAML connection

Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/saml/google.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ description: Learn how to integrate Google Workspace with Clerk using SAML SSO.

The value for the user's phone number will be saved in the user's `User.publicMetadata` under the key `phone_number`.

[Learn more about how to access the metadata from our APIs.](/docs/users/metadata)
[Learn more about how to access the metadata from our APIs](/docs/users/metadata).
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
[Learn more about how to access the metadata from our APIs](/docs/users/metadata).
Learn more about [how to access the metadata from our APIs](/docs/users/metadata).


### Enable the connection on Google

Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/saml/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -50,4 +50,4 @@ For development instances, SAML connections will always be free, but capped to 5

### Can I get a bulk discount?

Yes, [reach out to support](/contact/support){{ target: '_blank' }} to work out a custom plan.
Yes, [contact support](/contact/support){{ target: '_blank' }} to work out a custom plan.
2 changes: 1 addition & 1 deletion docs/authentication/social-connections/atlassian.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ For production instances, you will need to generate your own Client ID and Clien

## Before you start

- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, check out our [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [setup guide](/docs/quickstarts/setup-clerk).

- You need to have a Atlassian developer account. To create one, [click here](https://developer.atlassian.com/).

## Configuring an Atlassian OAuth 2.0 Integration
Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/social-connections/bitbucket.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ For production instances, you will need to generate your own Consumer Key and Co

## Before you start

- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, check out our [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [setup guide](/docs/quickstarts/setup-clerk).

- You need to have a Bitbucket account. To create one, [click here](https://bitbucket.org/account/signup).

## Configuring Bitbucket social connection
Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/social-connections/box.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ For production instances, you will need to generate your own Client ID and Clien

## Before you start

- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, check out our [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
Copy link
Member

Choose a reason for hiding this comment

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

ctrl + f "Set up your application guide" and change it to "setup guide"

Copy link
Contributor Author

Choose a reason for hiding this comment

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

- You need to have a Box developer account. To create one, [click here](https://developer.box.com/).

## Configuring Box social connection
Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/social-connections/dropbox.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ For production instances, you will need to generate your own Client ID and Clien

## Before you start

- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, check out our [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to have a Dropbox account. To create one, [click here](https://www.dropbox.com/lp/developers).

## Configuring Dropbox social connection
Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/social-connections/facebook.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ For production instances, you will need to create your own developer account wit

## Before you start

- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, check out our [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to have a Facebook Developer account. To create one, consult the [Register as a Facebook developer](https://developers.facebook.com/docs/development/register) page.

## Configuring Facebook social connection
Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/social-connections/hubspot.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ For production instances, you will need to create your own developer account wit

## Before you start

- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, check out our [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to have a HubSpot Developer account. To create one, [click here](https://app.hubspot.com/signup/developers/step/existing-user?_ga=2.145169076.1430980384.1628431607-741498900.1628431607).

## Configuring HubSpot social connection
Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/social-connections/line.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ For production instances, you will need to generate your own Client ID and Clien

## Before you start

- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, check out our [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to have a LINE developer account. To create one, [click here](https://developers.line.biz/en/).

## Configuring LINE social connection
Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/social-connections/linkedin.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ For production instances, you will need to generate your own Client ID and Clien

## Before you start

- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, check out our [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to have a LinkedIn account. To create one, [click here](https://developer.linkedin.com/).

## Configuring LinkedIn social connection
Expand Down
2 changes: 1 addition & 1 deletion docs/authentication/social-connections/notion.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ For production instances, you will need to generate your own Client ID and Clien

## Before you start

- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, check out our [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to create a Clerk Application in your [Clerk Dashboard](https://dashboard.clerk.com/). For more information, see the [Set up your application guide](/docs/quickstarts/setup-clerk).
- You need to have a Notion developer account. To create one, [click here](https://developers.notion.com/).

## Configuring Notion social connection
Expand Down
Loading
Loading