From e18ae30ed15f535c0ad216ad1955f317b4876a37 Mon Sep 17 00:00:00 2001 From: Thomas Hughes <2894107+IAmHughes@users.noreply.github.com> Date: Wed, 30 Jun 2021 16:08:23 -0500 Subject: [PATCH 1/9] Initial getting-started doc --- getting-started.md | 82 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 getting-started.md diff --git a/getting-started.md b/getting-started.md new file mode 100644 index 000000000..eaa680c32 --- /dev/null +++ b/getting-started.md @@ -0,0 +1,82 @@ +--- +title: "Getting Started" +description: Get Started with Coder. +--- + +We’re excited for you to be part of the growing community of Coder users, +and wanted to provide an onboarding guide to ensure you have a great +experience. Coder’s documentation is completely [open-source](https://github.com/cdr/docs), +so please feel free to contribute and provide feedback as you desire. + +## Setup and Deploy Coder + +To get started with Coder, you’ll need to [deploy Coder](./setup/index.md) into a +[Kubernetes cluster](./setup/kubernetes/index.md). We have documentation to assist you +with [creating a cluster](./setup/kubernetes/index.md) if needed as well. Once you +have a cluster, you can [install Coder via Helm](./setup/installation.md). + +## Configuring Coder + +When you first deploy Coder, you’ll need to [upload your license file](./setup/configuration.md) +to begin configuring the application. Once logged in, you’ll be able to access the +[administration management](.//admin/index.md) menu to set up things such as +[access controls](](.//admin/access-control/index.md) with OpenID Connect (OIDC), +[create organizations](./admin/organizations.md), and create an OAuth app for your users to +[connect to your git provider](./admin/git.md). + +At a minimum, you’ll want to ensure you [add a container registry](./admin/registries/index.md) +for your development environments to pull from, and then [import an image](./images/importing.md) +with the tools your developers need. You can [create custom images](./guides/customization/custom-workspace.md) +for your developer workspaces as well. + +## Provisioning Users + +With some base configuration done, you’ll want to allow your developers to begin using Coder. +[Within our Admin Guides](./guides/admin/index.md), we have steps to set up OpenID Connect (OIDC) with +[Azure AD](./guides/admin/oidc-azuread.md) and [Okta](./guides/admin/oidc-okta.md). If you are using +another Identity Provider (IdP), the process should be very similar. By configuring OIDC, when your +developers log in for the first time, their user will be created and added to the +[default organization](./admin/organizations.md). + +## Automation + +Coder has a [Command Line (CLI) tool](./cli/index.md) to interact with Coder that you and your developers +may be interested in. The CLI is completely [open-sourced](https://github.com/cdr/coder-cli), +and contributions are always welcome. Additionally, Coder has a [public API](./guides/api.md) to automate +various tasks through code. + +## Connecting Local IDEs + +While Coder does support a variety of IDEs in the browser, such as VSCode and the JetBrains product suite, +some developers may desire to use their local installation of these or other IDEs with Coder. +Leveraging the [Coder CLI](./cli/index.md), developers will be able to [connect their terminal](./cli/remote-terminal.md) +to the remote environment’s terminal, and enable [file sync](./cli/file-sync.md) to have your local +directory’s tree sync with the remote file system. + +## Maintenance and Updating + +Coder maintains a public [changelog](./changelog/index.md) and [release calendar](https://coder.com/release-calendar.ical) +to help you stay in the know on new features, bug fixes, security updates, and breaking changes that may be +coming. Coder releases are available on the third Wednesday of each month, and patch releases are +published and available as needed. + +## Interacting with Support + +Coder’s standard support is included with your license. You can reach us at `support@coder.com`, and one +of our engineers will be able to assist Please include any relevant logs, error messages, and/or screenshots. Coder also +has a [public community Slack](https://cdr.co/join-community) you can join if you’d like. Finally, Coder does offer premium +support through Coder Escalation Services, which provides a faster response Service-Level Agreement (SLA). +Speak to your account executive if you’re interested in this option. + +## Additional Information + +There are a variety of ways to follow Coder to stay up to date on company updates, whitepapers, blog posts, and more. + +- [Coder Blog](https://coder.com/blog) +- [Videos about Coder](https://coder.com/resources/videos) +- [Whitepapers](https://coder.com/resources/whitepapers) +- Social media accounts such as [LinkedIn](https://www.linkedin.com/company/coderhq), +[YouTube](https://www.youtube.com/channel/UCWexK_ECcUU3vEIdb-VYkfw), [Twitter](https://twitter.com/coderhq), and others + +Finally, we encourage you to look through the various [Guides](./guides/index.md) in our public documentation, +as it contains more detailed information on specific use cases and topics. From 981cc2c04e29c34b4e717c0f2fee79cb593385af Mon Sep 17 00:00:00 2001 From: Thomas Hughes <2894107+IAmHughes@users.noreply.github.com> Date: Thu, 1 Jul 2021 08:47:46 -0500 Subject: [PATCH 2/9] Hopefully fix linting --- getting-started.md | 79 ++++++++++++++++++++++++++++------------------ 1 file changed, 48 insertions(+), 31 deletions(-) diff --git a/getting-started.md b/getting-started.md index eaa680c32..48c73c6bb 100644 --- a/getting-started.md +++ b/getting-started.md @@ -11,9 +11,10 @@ so please feel free to contribute and provide feedback as you desire. ## Setup and Deploy Coder To get started with Coder, you’ll need to [deploy Coder](./setup/index.md) into a -[Kubernetes cluster](./setup/kubernetes/index.md). We have documentation to assist you -with [creating a cluster](./setup/kubernetes/index.md) if needed as well. Once you -have a cluster, you can [install Coder via Helm](./setup/installation.md). +[Kubernetes cluster](./setup/kubernetes/index.md). We have documentation +to assist you with [creating a cluster](./setup/kubernetes/index.md) if +needed as well. Once you have a cluster, you can +[install Coder via Helm](./setup/installation.md). ## Configuring Coder @@ -21,8 +22,8 @@ When you first deploy Coder, you’ll need to [upload your license file](./setup to begin configuring the application. Once logged in, you’ll be able to access the [administration management](.//admin/index.md) menu to set up things such as [access controls](](.//admin/access-control/index.md) with OpenID Connect (OIDC), -[create organizations](./admin/organizations.md), and create an OAuth app for your users to -[connect to your git provider](./admin/git.md). +[create organizations](./admin/organizations.md), and create an +OAuth app for your users to [connect to your git provider](./admin/git.md). At a minimum, you’ll want to ensure you [add a container registry](./admin/registries/index.md) for your development environments to pull from, and then [import an image](./images/importing.md) @@ -31,52 +32,68 @@ for your developer workspaces as well. ## Provisioning Users -With some base configuration done, you’ll want to allow your developers to begin using Coder. -[Within our Admin Guides](./guides/admin/index.md), we have steps to set up OpenID Connect (OIDC) with -[Azure AD](./guides/admin/oidc-azuread.md) and [Okta](./guides/admin/oidc-okta.md). If you are using -another Identity Provider (IdP), the process should be very similar. By configuring OIDC, when your -developers log in for the first time, their user will be created and added to the +With some base configuration done, you’ll want to allow your +developers to begin using Coder. [Within our Admin Guides](./guides/admin/index.md), +we have steps to set up OpenID Connect (OIDC) with +[Azure AD](./guides/admin/oidc-azuread.md) and +[Okta](./guides/admin/oidc-okta.md). If you are using another +Identity Provider (IdP), the process should be very similar. +By configuring OIDC, when your developers log in for the first +time, their user will be created and added to the [default organization](./admin/organizations.md). ## Automation -Coder has a [Command Line (CLI) tool](./cli/index.md) to interact with Coder that you and your developers -may be interested in. The CLI is completely [open-sourced](https://github.com/cdr/coder-cli), -and contributions are always welcome. Additionally, Coder has a [public API](./guides/api.md) to automate -various tasks through code. +Coder has a [Command Line (CLI) tool](./cli/index.md) to interact +with Coder that you and your developers may be interested in. The CLI +is completely [open-sourced](https://github.com/cdr/coder-cli), +and contributions are always welcome. Additionally, Coder has a +[public API](./guides/api.md) to automate various tasks +through code. ## Connecting Local IDEs -While Coder does support a variety of IDEs in the browser, such as VSCode and the JetBrains product suite, -some developers may desire to use their local installation of these or other IDEs with Coder. -Leveraging the [Coder CLI](./cli/index.md), developers will be able to [connect their terminal](./cli/remote-terminal.md) -to the remote environment’s terminal, and enable [file sync](./cli/file-sync.md) to have your local -directory’s tree sync with the remote file system. +While Coder does support a variety of IDEs in the browser, such as +VSCode and the JetBrains product suite, some developers may desire +to use their local installation of these or other IDEs with Coder. +Leveraging the [Coder CLI](./cli/index.md), developers will be able +to [connect their terminal](./cli/remote-terminal.md) to the remote +environment’s terminal, and enable [file sync](./cli/file-sync.md) +to have your local directory’s tree sync with the remote file system. ## Maintenance and Updating Coder maintains a public [changelog](./changelog/index.md) and [release calendar](https://coder.com/release-calendar.ical) -to help you stay in the know on new features, bug fixes, security updates, and breaking changes that may be -coming. Coder releases are available on the third Wednesday of each month, and patch releases are -published and available as needed. +to help you stay in the know on new features, bug fixes, security updates, +and breaking changes that may be coming. Coder releases are available +on the third Wednesday of each month, and patch releases are published +and available as needed. ## Interacting with Support -Coder’s standard support is included with your license. You can reach us at `support@coder.com`, and one -of our engineers will be able to assist Please include any relevant logs, error messages, and/or screenshots. Coder also -has a [public community Slack](https://cdr.co/join-community) you can join if you’d like. Finally, Coder does offer premium -support through Coder Escalation Services, which provides a faster response Service-Level Agreement (SLA). -Speak to your account executive if you’re interested in this option. +Coder’s standard support is included with your license. You can +reach us at `support@coder.com`, and one of our engineers +will be able to assist Please include any relevant logs, +error messages, and/or screenshots. Coder also has a +[public community Slack](https://cdr.co/join-community) you can +join if you’d like. Finally, Coder does offer premium support +through Coder Escalation Services, which provides a faster +response Service-Level Agreement (SLA). Speak to your account executive +if you’re interested in this option. ## Additional Information -There are a variety of ways to follow Coder to stay up to date on company updates, whitepapers, blog posts, and more. +There are a variety of ways to follow Coder to stay up to date +on company updates, whitepapers, blog posts, and more. - [Coder Blog](https://coder.com/blog) - [Videos about Coder](https://coder.com/resources/videos) - [Whitepapers](https://coder.com/resources/whitepapers) - Social media accounts such as [LinkedIn](https://www.linkedin.com/company/coderhq), -[YouTube](https://www.youtube.com/channel/UCWexK_ECcUU3vEIdb-VYkfw), [Twitter](https://twitter.com/coderhq), and others +[YouTube](https://www.youtube.com/channel/UCWexK_ECcUU3vEIdb-VYkfw), +[Twitter](https://twitter.com/coderhq), and others -Finally, we encourage you to look through the various [Guides](./guides/index.md) in our public documentation, -as it contains more detailed information on specific use cases and topics. +Finally, we encourage you to look through the various +[Guides](./guides/index.md) in our public documentation, +as it contains more detailed information on specific +use cases and topics. From dc4cc26ffc447b3188edf073ec052773b3cfe67f Mon Sep 17 00:00:00 2001 From: Katie Horne Date: Fri, 2 Jul 2021 14:38:49 -0500 Subject: [PATCH 3/9] Edit text and add to manifest --- getting-started.md | 179 +++++++++++++++++++++++---------------------- manifest.json | 3 + 2 files changed, 94 insertions(+), 88 deletions(-) diff --git a/getting-started.md b/getting-started.md index 48c73c6bb..ac657c458 100644 --- a/getting-started.md +++ b/getting-started.md @@ -1,99 +1,102 @@ --- -title: "Getting Started" -description: Get Started with Coder. +title: "Getting started" +description: Get started with Coder. --- -We’re excited for you to be part of the growing community of Coder users, -and wanted to provide an onboarding guide to ensure you have a great -experience. Coder’s documentation is completely [open-source](https://github.com/cdr/docs), +We’re excited for you to be part of the growing community of Coder users, and we +wanted to provide an onboarding guide to ensure you have a great experience. +Coder’s [documentation is completely open-source](https://github.com/cdr/docs), so please feel free to contribute and provide feedback as you desire. -## Setup and Deploy Coder - -To get started with Coder, you’ll need to [deploy Coder](./setup/index.md) into a -[Kubernetes cluster](./setup/kubernetes/index.md). We have documentation -to assist you with [creating a cluster](./setup/kubernetes/index.md) if -needed as well. Once you have a cluster, you can -[install Coder via Helm](./setup/installation.md). - -## Configuring Coder - -When you first deploy Coder, you’ll need to [upload your license file](./setup/configuration.md) -to begin configuring the application. Once logged in, you’ll be able to access the -[administration management](.//admin/index.md) menu to set up things such as -[access controls](](.//admin/access-control/index.md) with OpenID Connect (OIDC), -[create organizations](./admin/organizations.md), and create an -OAuth app for your users to [connect to your git provider](./admin/git.md). - -At a minimum, you’ll want to ensure you [add a container registry](./admin/registries/index.md) -for your development environments to pull from, and then [import an image](./images/importing.md) -with the tools your developers need. You can [create custom images](./guides/customization/custom-workspace.md) -for your developer workspaces as well. - -## Provisioning Users - -With some base configuration done, you’ll want to allow your -developers to begin using Coder. [Within our Admin Guides](./guides/admin/index.md), -we have steps to set up OpenID Connect (OIDC) with -[Azure AD](./guides/admin/oidc-azuread.md) and -[Okta](./guides/admin/oidc-okta.md). If you are using another -Identity Provider (IdP), the process should be very similar. -By configuring OIDC, when your developers log in for the first -time, their user will be created and added to the -[default organization](./admin/organizations.md). - -## Automation - -Coder has a [Command Line (CLI) tool](./cli/index.md) to interact -with Coder that you and your developers may be interested in. The CLI -is completely [open-sourced](https://github.com/cdr/coder-cli), -and contributions are always welcome. Additionally, Coder has a -[public API](./guides/api.md) to automate various tasks -through code. - -## Connecting Local IDEs - -While Coder does support a variety of IDEs in the browser, such as -VSCode and the JetBrains product suite, some developers may desire -to use their local installation of these or other IDEs with Coder. -Leveraging the [Coder CLI](./cli/index.md), developers will be able -to [connect their terminal](./cli/remote-terminal.md) to the remote -environment’s terminal, and enable [file sync](./cli/file-sync.md) -to have your local directory’s tree sync with the remote file system. - -## Maintenance and Updating - -Coder maintains a public [changelog](./changelog/index.md) and [release calendar](https://coder.com/release-calendar.ical) -to help you stay in the know on new features, bug fixes, security updates, -and breaking changes that may be coming. Coder releases are available -on the third Wednesday of each month, and patch releases are published -and available as needed. - -## Interacting with Support - -Coder’s standard support is included with your license. You can -reach us at `support@coder.com`, and one of our engineers -will be able to assist Please include any relevant logs, -error messages, and/or screenshots. Coder also has a -[public community Slack](https://cdr.co/join-community) you can -join if you’d like. Finally, Coder does offer premium support -through Coder Escalation Services, which provides a faster -response Service-Level Agreement (SLA). Speak to your account executive -if you’re interested in this option. - -## Additional Information - -There are a variety of ways to follow Coder to stay up to date -on company updates, whitepapers, blog posts, and more. +## Setup and deploy Coder + +To get started with Coder, you’ll need to [deploy Coder](./setup/index.md) to a +[Kubernetes cluster](./setup/kubernetes/index.md). We have documentation to +assist you with [creating a cluster](./setup/kubernetes/index.md) if needed. +Once you have a cluster, you can [install Coder via +Helm](./setup/installation.md). + +## Configure Coder + +After you deploy Coder, you’ll need to [upload your license +file](./setup/configuration.md) before you can configure the application. Once +logged in, you’ll be able to access the [administration +management](.//admin/index.md) menu to set up things such as [access +controls](](.//admin/access-control/index.md) with OpenID Connect (OIDC), +[create organizations](./admin/organizations.md), and create an OAuth app for +your users to [connect to your Git provider](./admin/git.md). + +At a minimum, you’ll want to ensure you [add a container +registry](./admin/registries/index.md) for your development environments to pull +from, and [import an image](./images/importing.md) with the tools your +developers need. You can [create custom +images](./guides/customization/custom-workspace.md) for your developer +workspaces as well. + +## Provision users + +With some base configuration done, you’ll want to allow your developers to begin +using Coder. [Within our Admin Guides](./guides/admin/index.md), we have steps +to set up OpenID Connect (OIDC) with [Azure AD](./guides/admin/oidc-azuread.md) +or [Okta](./guides/admin/oidc-okta.md). If you are using another Identity +Provider (IdP), the process should be very similar. With OIDC configured, Coder +will automatically create a user and add them to the [default +organization](./admin/organizations.md) when a developer logs in for the first +time. + +## Automate + +Coder has a [command-line (CLI) tool](./cli/index.md) that you and your +developers may be interested in using to interact with Coder. The CLI is +completely [open-sourced](https://github.com/cdr/coder-cli), and we always +welcome contributions. Additionally, Coder has a [public API](./guides/api.md) +that you can use to automate various tasks through code. + +## Connect local IDEs + +While Coder supports a variety of IDEs in the browser, such as VSCode and the +JetBrains product suite, some developers may want to use their local +installation of these tools or other IDEs with Coder. By leveraging the [Coder +CLI](./cli/index.md), developers will be able to [connect their +terminal](./cli/remote-terminal.md) to the remote environment’s terminal, and +enable [file sync](./cli/file-sync.md) to have their local directory’s tree sync +with the remote file system. + +## Maintain and update + +Coder maintains a public [changelog](./changelog/index.md) and [release +calendar](https://coder.com/release-calendar.ical) to help you stay in the know +on features, bug fixes, security updates, and breaking changes that are coming. +Coder releases are available on the third Wednesday of each month, and patch +releases are published and available as needed. + +## Interact with Support + +Coder’s standard support is included with your license. You can reach us at +[support@coder.com](mailto:support@coder.com), and one of our engineers will be +able to assist. Please include any relevant logs, error messages, or +screenshots. + +Coder also has a [public community Slack](https://cdr.co/join-community) you can +join if you’d like. + +Finally, Coder offers premium support through Coder Escalation Services, which +provides a faster response Service-Level Agreement (SLA). Speak to your account +executive if you’re interested in this option. + +## Additional information + +There are a variety of ways to follow Coder to stay up-to-date on company +updates, whitepapers, blog posts, and more. - [Coder Blog](https://coder.com/blog) - [Videos about Coder](https://coder.com/resources/videos) - [Whitepapers](https://coder.com/resources/whitepapers) -- Social media accounts such as [LinkedIn](https://www.linkedin.com/company/coderhq), -[YouTube](https://www.youtube.com/channel/UCWexK_ECcUU3vEIdb-VYkfw), -[Twitter](https://twitter.com/coderhq), and others +- Social media accounts such as + [LinkedIn](https://www.linkedin.com/company/coderhq), + [YouTube](https://www.youtube.com/channel/UCWexK_ECcUU3vEIdb-VYkfw), + [Twitter](https://twitter.com/coderhq), and others Finally, we encourage you to look through the various -[Guides](./guides/index.md) in our public documentation, -as it contains more detailed information on specific -use cases and topics. +[Guides](./guides/index.md) in our public documentation, as it contains more +detailed information on specific use cases and topics. diff --git a/manifest.json b/manifest.json index 6b8c6fa08..8fbb49fc1 100644 --- a/manifest.json +++ b/manifest.json @@ -15,6 +15,9 @@ } ] }, + { + "path": "getting-started.md" + }, { "path": "./workspaces/index.md", "children": [ From ac82d5a029d8305f74e30737b416f4c033b909e7 Mon Sep 17 00:00:00 2001 From: Thomas Hughes <2894107+IAmHughes@users.noreply.github.com> Date: Sun, 4 Jul 2021 13:41:07 -0500 Subject: [PATCH 4/9] Update getting-started.md Co-authored-by: Ben Potter --- getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started.md b/getting-started.md index ac657c458..9e826b904 100644 --- a/getting-started.md +++ b/getting-started.md @@ -54,7 +54,7 @@ that you can use to automate various tasks through code. ## Connect local IDEs -While Coder supports a variety of IDEs in the browser, such as VSCode and the +While Coder supports a [variety of IDEs in the browser](https://coder.com/docs/coder/v1.20/workspaces/editors), such as VSCode and the JetBrains product suite, some developers may want to use their local installation of these tools or other IDEs with Coder. By leveraging the [Coder CLI](./cli/index.md), developers will be able to [connect their From 0991bb431fd0366ea3da2247b5b53bdcda0a349e Mon Sep 17 00:00:00 2001 From: Katie Horne Date: Tue, 6 Jul 2021 10:40:03 -0500 Subject: [PATCH 5/9] Add icon --- getting-started.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/getting-started.md b/getting-started.md index ac657c458..29017d08c 100644 --- a/getting-started.md +++ b/getting-started.md @@ -1,6 +1,8 @@ --- title: "Getting started" description: Get started with Coder. +icon: + '' --- We’re excited for you to be part of the growing community of Coder users, and we From fedafc7248db35c57fb80b7f62c80e5e38500365 Mon Sep 17 00:00:00 2001 From: Katie Horne Date: Tue, 6 Jul 2021 10:51:51 -0500 Subject: [PATCH 6/9] Update icon; lint --- getting-started.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/getting-started.md b/getting-started.md index 2e7ef823b..8843264b8 100644 --- a/getting-started.md +++ b/getting-started.md @@ -1,8 +1,7 @@ --- title: "Getting started" description: Get started with Coder. -icon: - '' +icon: '' --- We’re excited for you to be part of the growing community of Coder users, and we @@ -56,8 +55,9 @@ that you can use to automate various tasks through code. ## Connect local IDEs -While Coder supports a [variety of IDEs in the browser](https://coder.com/docs/coder/v1.20/workspaces/editors), such as VSCode and the -JetBrains product suite, some developers may want to use their local +While Coder supports a [variety of IDEs in the +browser](https://coder.com/docs/coder/v1.20/workspaces/editors), such as VSCode +and the JetBrains product suite, some developers may want to use their local installation of these tools or other IDEs with Coder. By leveraging the [Coder CLI](./cli/index.md), developers will be able to [connect their terminal](./cli/remote-terminal.md) to the remote environment’s terminal, and From 6543e6cb1b7ca04d3410c87d82df9befccfae426 Mon Sep 17 00:00:00 2001 From: Katie Horne Date: Tue, 6 Jul 2021 10:58:56 -0500 Subject: [PATCH 7/9] Apply changes based on review --- getting-started.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/getting-started.md b/getting-started.md index 8843264b8..c865e5904 100644 --- a/getting-started.md +++ b/getting-started.md @@ -12,17 +12,17 @@ so please feel free to contribute and provide feedback as you desire. ## Setup and deploy Coder To get started with Coder, you’ll need to [deploy Coder](./setup/index.md) to a -[Kubernetes cluster](./setup/kubernetes/index.md). We have documentation to -assist you with [creating a cluster](./setup/kubernetes/index.md) if needed. -Once you have a cluster, you can [install Coder via -Helm](./setup/installation.md). +Kubernetes cluster. We have documentation to help you [create a +cluster](./setup/kubernetes/index.md) if needed. Once you have a cluster, you +can [install Coder via Helm](./setup/installation.md). ## Configure Coder After you deploy Coder, you’ll need to [upload your license -file](./setup/configuration.md) before you can configure the application. Once -logged in, you’ll be able to access the [administration -management](.//admin/index.md) menu to set up things such as [access +file](./setup/configuration.md) before you can configure the application (you +can get a trial license for free [here](https://coder.com/trial)). Once logged +in, you’ll be able to access the [administration management](.//admin/index.md) +menu to set up things such as [access controls](](.//admin/access-control/index.md) with OpenID Connect (OIDC), [create organizations](./admin/organizations.md), and create an OAuth app for your users to [connect to your Git provider](./admin/git.md). @@ -37,11 +37,11 @@ workspaces as well. ## Provision users With some base configuration done, you’ll want to allow your developers to begin -using Coder. [Within our Admin Guides](./guides/admin/index.md), we have steps -to set up OpenID Connect (OIDC) with [Azure AD](./guides/admin/oidc-azuread.md) -or [Okta](./guides/admin/oidc-okta.md). If you are using another Identity -Provider (IdP), the process should be very similar. With OIDC configured, Coder -will automatically create a user and add them to the [default +using Coder. You can manually create and invite users, or you can set up OpenID +Connect (OIDC) with [Azure AD](./guides/admin/oidc-azuread.md) or +[Okta](./guides/admin/oidc-okta.md). If you are using another Identity Provider +(IdP), the process should be very similar. With OIDC configured, Coder will +automatically create a user and add them to the [default organization](./admin/organizations.md) when a developer logs in for the first time. From 5073243245b7d44eda7a3ce5c39fcded61b39c22 Mon Sep 17 00:00:00 2001 From: Thomas Hughes <2894107+IAmHughes@users.noreply.github.com> Date: Tue, 6 Jul 2021 14:33:23 -0500 Subject: [PATCH 8/9] Fix link formatting issue --- getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/getting-started.md b/getting-started.md index c865e5904..94abcbbd7 100644 --- a/getting-started.md +++ b/getting-started.md @@ -23,7 +23,7 @@ file](./setup/configuration.md) before you can configure the application (you can get a trial license for free [here](https://coder.com/trial)). Once logged in, you’ll be able to access the [administration management](.//admin/index.md) menu to set up things such as [access -controls](](.//admin/access-control/index.md) with OpenID Connect (OIDC), +controls](.//admin/access-control/index.md) with OpenID Connect (OIDC), [create organizations](./admin/organizations.md), and create an OAuth app for your users to [connect to your Git provider](./admin/git.md). From e581a786cfe120068212474244506587ed180e3d Mon Sep 17 00:00:00 2001 From: Katie Horne Date: Wed, 7 Jul 2021 09:03:31 -0500 Subject: [PATCH 9/9] Apply suggestions from code review Co-authored-by: Ben Potter --- getting-started.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/getting-started.md b/getting-started.md index 94abcbbd7..9bdcd363d 100644 --- a/getting-started.md +++ b/getting-started.md @@ -6,7 +6,7 @@ icon: '