docs: add frontmatter for search indexing on docs page (#73)

This adds frontmatter entries for the name of each method,
the scope, an example snippet, a route, and a type of 'API method'
to help with indexing search results on octokit.github.io/rest.js

Author: copperwall

docs/actions/cancelWorkflowRun.md

@@ -1,3 +1,11 @@
+---
+name: Cancel a workflow run
+example: octokit.actions.cancelWorkflowRun({ owner, repo, run_id })
+route: POST /repos/{owner}/{repo}/actions/runs/{run_id}/cancel
+scope: actions
+type: API method
+---
+
 # Cancel a workflow run
 
 Cancels a workflow run using its `id`. Anyone with write access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.

docs/actions/createOrUpdateSecretForRepo.md

@@ -1,3 +1,11 @@
+---
+name: Create or update a secret for a repository
+example: octokit.actions.createOrUpdateSecretForRepo({ owner, repo, name })
+route: PUT /repos/{owner}/{repo}/actions/secrets/{name}
+scope: actions
+type: API method
+---
+
 # Create or update a secret for a repository
 
 Creates or updates a secret with an encrypted value. Encrypt your secret using [LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages). Anyone with write access to the repository can use this endpoint. GitHub Apps must have the `secrets` permission to use this endpoint.

docs/actions/createRegistrationToken.md

@@ -1,3 +1,11 @@
+---
+name: Create a registration token for a repository
+example: octokit.actions.createRegistrationToken({ owner, repo })
+route: POST /repos/{owner}/{repo}/actions/runners/registration-token
+scope: actions
+type: API method
+---
+
 # Create a registration token for a repository
 
 **Deprecated:** This method has been renamed to actions.createRegistrationTokenForRepo

docs/actions/createRegistrationTokenForOrg.md

@@ -1,3 +1,11 @@
+---
+name: Create a registration token for an organization
+example: octokit.actions.createRegistrationTokenForOrg({ org })
+route: POST /orgs/{org}/actions/runners/registration-token
+scope: actions
+type: API method
+---
+
 # Create a registration token for an organization
 
 **Warning:** The self-hosted runners API for organizations is currently in public beta and subject to change.

docs/actions/createRegistrationTokenForRepo.md

@@ -1,3 +1,11 @@
+---
+name: Create a registration token for a repository
+example: octokit.actions.createRegistrationTokenForRepo({ owner, repo })
+route: POST /repos/{owner}/{repo}/actions/runners/registration-token
+scope: actions
+type: API method
+---
+
 # Create a registration token for a repository
 
 Returns a token that you can pass to the `config` script. The token expires after one hour. Anyone with admin access to the repository can use this endpoint. GitHub Apps must have the `administration:write` repository permission to use this endpoint.

docs/actions/createRemoveToken.md

@@ -1,3 +1,11 @@
+---
+name: Create a remove token for a repository
+example: octokit.actions.createRemoveToken({ owner, repo })
+route: POST /repos/{owner}/{repo}/actions/runners/remove-token
+scope: actions
+type: API method
+---
+
 # Create a remove token for a repository
 
 **Deprecated:** This method has been renamed to actions.createRemoveTokenForRepo

docs/actions/createRemoveTokenForOrg.md

@@ -1,3 +1,11 @@
+---
+name: Create a remove token for an organization
+example: octokit.actions.createRemoveTokenForOrg({ org })
+route: POST /orgs/{org}/actions/runners/remove-token
+scope: actions
+type: API method
+---
+
 # Create a remove token for an organization
 
 **Warning:** The self-hosted runners API for organizations is currently in public beta and subject to change.

docs/actions/createRemoveTokenForRepo.md

@@ -1,3 +1,11 @@
+---
+name: Create a remove token for a repository
+example: octokit.actions.createRemoveTokenForRepo({ owner, repo })
+route: POST /repos/{owner}/{repo}/actions/runners/remove-token
+scope: actions
+type: API method
+---
+
 # Create a remove token for a repository
 
 Returns a token that you can pass to remove a self-hosted runner from a repository. The token expires after one hour. Anyone with admin access to the repository can use this endpoint. GitHub Apps must have the `administration:write` repository permission to use this endpoint.

docs/actions/deleteArtifact.md

@@ -1,3 +1,11 @@
+---
+name: Delete an artifact
+example: octokit.actions.deleteArtifact({ owner, repo, artifact_id })
+route: DELETE /repos/{owner}/{repo}/actions/artifacts/{artifact_id}
+scope: actions
+type: API method
+---
+
 # Delete an artifact
 
 Deletes an artifact for a workflow run. Anyone with write access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.

docs/actions/deleteSecretFromRepo.md

@@ -1,3 +1,11 @@
+---
+name: Delete a secret from a repository
+example: octokit.actions.deleteSecretFromRepo({ owner, repo, name })
+route: DELETE /repos/{owner}/{repo}/actions/secrets/{name}
+scope: actions
+type: API method
+---
+
 # Delete a secret from a repository
 
 Deletes a secret in a repository using the secret name. Anyone with write access to the repository can use this endpoint. GitHub Apps must have the `secrets` permission to use this endpoint.