Improve getting started documentation (#1561)

- Fix typos
- Make repository deletion instructions consistent
- Avoid getting "profile already exists" error when enabling remediation

docs/docs/getting_started/first_profile.md

@@ -91,7 +91,7 @@ minder profile_status list --profile github-profile --detailed
 ## Viewing alerts
 
 Disable secret scanning in one of the registered repositories, by following 
-[these instructions provided by GitHub](https://docs.github.com/en/code-security/secret-scanning/configuring-secret-scanning-for-your-repositories):
+[these instructions provided by GitHub](https://docs.github.com/en/code-security/secret-scanning/configuring-secret-scanning-for-your-repositories).
 
 Navigate to the repository on GitHub, click on the Security tab and view the Security Advisories.  
 Notice that there is a new advisory titled `minder: profile github-profile failed with rule secret_scanning`.
@@ -103,8 +103,10 @@ Navigate to the repository on GitHub, click on the Security tab and view the Sec
 Notice that the advisory titled `minder: profile github-profile failed with rule secret_scanning` is now closed.
 
 ## Delete registered repositories
-If you wish to delete a registered repository, you can do so with the following command:
+If you want to stop monitoring a repository, you can delete it from Minder by using the `repo delete` command:
 ```bash
-minder repo delete -n $REPO_NAME --provider github
+minder repo delete --provider github --name $REPO_NAME
 ```
 where `$REPO_NAME` is the fully-qualified name (`owner/name`) of the repository you wish to delete, for example `testorg/testrepo`.
+
+This will delete the repository from Minder and remove the webhook from the repository. 

docs/docs/getting_started/remediations.md

@@ -9,7 +9,7 @@ In [Creating your first profile](./first_profile.md), we wrote a rule to open a
 security advisory when repo configuration drifted from the configured profile
 in Minder.  In this tutorial, we will show how Minder can automatically
 resolve the misconfiguration and ensure that enrolled repos have secret
-scanning enabled.  Secret scanning isone of several settings which can be
+scanning enabled.  Secret scanning is one of several settings which can be
 managed by Minder.  When you apply a Minder profile to enrolled repositories,
 it will remediate (fix) the setting if it is changed to violate the profile.
 
@@ -19,20 +19,20 @@ it will remediate (fix) the setting if it is changed to violate the profile.
 * [A Minder account](./login.md)
 * [An enrolled GitHub token](./login.md#enrolling-the-github-provider) that is either an Owner in the organization or an Admin on the repositories
 * [A registered repository in Minder](./first_profile.md#register-repositories)
-* [The `secret_scanning`` rule type](./first_profile.md#creating-and-applying-profiles)
+* [The `secret_scanning` rule type](./first_profile.md#creating-and-applying-profiles)
 * [A policy to open security advisories when secret scanning is off](./first_profile.md#creating-and-applying-profiles)
 
 ## Creating a profile with `remediate: on`
 
 Minder doesn't currently support editing profiles, so we will create a new profile with `remediate: on`.
 
-Edit the YAML file of the [profile from the secret-scanning tutorial](./first_profile.md#creating-and-applying-profiles)
-and set the `remediate` attribute to `on`:
+Create a new file called `profile-remediate.yaml`.
+Paste the following profile definition into the newly created file, setting the `remediate` attribute to `on`:
 ```yaml
 ---
 version: v1
 type: profile
-name: github-profile
+name: github-profile-remediate
 context:
   provider: github
 alert: "on"
@@ -45,12 +45,12 @@ repository:
 
 Create the profile in Minder:
 ```
-minder profile create -f profile.yaml
+minder profile create -f profile-remediate.yaml
 ```
 
 Check the status of the profile:
 ```
-minder profile_status list --profile github-profile
+minder profile_status list --profile github-profile-remediate
 ```
 
 With remediation on, the profile status should be "Success" when the repository has been updated to match the profile.