docs: new endpoints and deprecations coming from restructuring in GitHubs REST API docs

Author: gr2m

docs/actions/listJobsForWorkflowRun.md

@@ -1,6 +1,6 @@
 # List jobs for a workflow run
 
-Lists jobs for a workflow run. Anyone with read access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint.
+Lists jobs for a workflow run. Anyone with read access to the repository can use this endpoint. GitHub Apps must have the `actions` permission to use this endpoint. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://developer.github.com/v3/#parameters).
 
 ```js
 octokit.actions.listJobsForWorkflowRun({
@@ -35,6 +35,13 @@ repo parameter
 
 run_id parameter
 
+</td></tr>
+<tr><td>filter</td><td>no</td><td>
+
+Filters jobs by their `completed_at` timestamp. Can be one of:  
+\* `latest`: Returns jobs from the most recent execution of the workflow run.  
+\* `all`: Returns all jobs for a workflow run, including from old executions of the workflow run.
+
 </td></tr>
 <tr><td>per_page</td><td>no</td><td>
 

docs/activity/deleteRepoSubscription.md

@@ -1,4 +1,4 @@
-# Delete a Repository Subscription
+# Delete a repository subscription
 
 This endpoint should only be used to stop watching a repository. To control whether or not you wish to receive notifications from a repository, [set the repository's subscription manually](https://developer.github.com/v3/activity/watching/#set-a-repository-subscription).
 

docs/activity/getRepoSubscription.md

@@ -1,4 +1,4 @@
-# Get a Repository Subscription
+# Get a repository subscription
 
 ```js
 octokit.activity.getRepoSubscription({

docs/activity/listReposStarredByAuthenticatedUser.md

@@ -1,4 +1,6 @@
-# List repositories being starred by the authenticated user
+# List repositories starred by the authenticated user
+
+Lists repositories the authenticated user has starred.
 
 You can also find out _when_ stars were created by passing the following custom [media type](https://developer.github.com/v3/media/) via the `Accept` header:
 

docs/activity/listReposStarredByUser.md

@@ -1,4 +1,6 @@
-# List repositories being starred by a user
+# List repositories starred by a user
+
+Lists repositories a user has starred.
 
 You can also find out _when_ stars were created by passing the following custom [media type](https://developer.github.com/v3/media/) via the `Accept` header:
 

docs/activity/listReposWatchedByUser.md

@@ -1,4 +1,6 @@
-# List repositories being watched by a user
+# List repositories watched by a user
+
+Lists repositories a user is watching.
 
 ```js
 octokit.activity.listReposWatchedByUser({

docs/activity/listWatchedReposForAuthenticatedUser.md

@@ -1,4 +1,6 @@
-# List repositories being watched by the authenticated user
+# List repositories watched by the authenticated user
+
+Lists repositories the authenticated user is watching.
 
 ```js
 octokit.activity.listWatchedReposForAuthenticatedUser();

docs/activity/listWatchersForRepo.md

@@ -1,5 +1,7 @@
 # List watchers
 
+Lists the people watching the specified repository.
+
 ```js
 octokit.activity.listWatchersForRepo({
   owner,

docs/activity/setRepoSubscription.md

@@ -1,4 +1,4 @@
-# Set a Repository Subscription
+# Set a repository subscription
 
 If you would like to watch a repository, set `subscribed` to `true`. If you would like to ignore notifications made within a repository, set `ignored` to `true`. If you would like to stop watching a repository, [delete the repository's subscription](https://developer.github.com/v3/activity/watching/#delete-a-repository-subscription) completely.
 

docs/apps/checkAccountIsAssociatedWithAny.md

@@ -1,4 +1,6 @@
-# Check if a GitHub account is associated with any Marketplace listing
+# Get a subscription plan for an account
+
+**Deprecated:** This method has been renamed to apps.getSubscriptionPlanForAccount
 
 Shows whether the user or organization account actively subscribes to a plan listed by the authenticated GitHub App. When someone submits a plan change that won't be processed until the end of their billing cycle, you will also see the upcoming pending change.