feat: renamed methods to mirror latest documentation updates (#59)

Co-authored-by: Octokit Bot <[email protected]>

Author: github-actions[bot]

docs/activity/checkRepoIsStarredByAuthenticatedUser.md

@@ -0,0 +1,34 @@
+# Check if a repository is starred by the authenticated user
+
+```js
+octokit.activity.checkRepoIsStarredByAuthenticatedUser({
+  owner,
+  repo,
+});
+```
+
+## Parameters
+
+<table>
+  <thead>
+    <tr>
+      <th>name</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>owner</td><td>yes</td><td>
+
+owner parameter
+
+</td></tr>
+<tr><td>repo</td><td>yes</td><td>
+
+repo parameter
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user).

docs/activity/checkStarringRepo.md

@@ -1,6 +1,6 @@
-# Check if you are starring a repository
+# Check if a repository is starred by the authenticated user
 
-Requires for the user to be authenticated.
+**Deprecated:** This method has been renamed to activity.checkRepoIsStarredByAuthenticatedUser
 
 ```js
 octokit.activity.checkStarringRepo({
@@ -33,4 +33,4 @@ repo parameter
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/starring/#check-if-you-are-starring-a-repository).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/starring/#check-if-a-repository-is-starred-by-the-authenticated-user).

docs/activity/deleteThreadSubscription.md

@@ -1,6 +1,6 @@
 # Delete a thread subscription
 
-Mutes all future notifications for a conversation until you comment on the thread or get **@mention**ed.
+Mutes all future notifications for a conversation until you comment on the thread or get an **@mention**. If you are watching the repository of the thread, you will still receive notifications. To ignore future notifications for a repository you are watching, use the [Set a thread subscription](https://developer.github.com/v3/activity/notifications/#set-a-thread-subscription) endpoint and set `ignore` to `true`.
 
 ```js
 octokit.activity.deleteThreadSubscription({

docs/activity/getFeeds.md

@@ -0,0 +1,23 @@
+# Get feeds
+
+GitHub provides several timeline resources in [Atom](<http://en.wikipedia.org/wiki/Atom_(standard)>) format. The Feeds API lists all the feeds available to the authenticated user:
+
+- **Timeline**: The GitHub global public timeline
+- **User**: The public timeline for any user, using [URI template](https://developer.github.com/v3/#hypermedia)
+- **Current user public**: The public timeline for the authenticated user
+- **Current user**: The private timeline for the authenticated user
+- **Current user actor**: The private timeline for activity created by the authenticated user
+- **Current user organizations**: The private timeline for the organizations the authenticated user is a member of.
+- **Security advisories**: A collection of public announcements that provide information about security-related vulnerabilities in software on GitHub.
+
+**Note**: Private feeds are only returned when [authenticating via Basic Auth](https://developer.github.com/v3/#basic-authentication) since current feed URIs use the older, non revocable auth tokens.
+
+```js
+octokit.activity.getFeeds();
+```
+
+## Parameters
+
+This endpoint has no parameters
+
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/feeds/#get-feeds).

docs/activity/getThread.md

@@ -1,4 +1,4 @@
-# View a single thread
+# Get a thread
 
 ```js
 octokit.activity.getThread({
@@ -25,4 +25,4 @@ thread_id parameter
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/notifications/#view-a-single-thread).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/notifications/#get-a-thread).

docs/activity/getThreadSubscription.md

@@ -1,13 +1,11 @@
-# Get a thread subscription
+# Mark notifications as read
 
-This checks to see if the current user is subscribed to a thread. You can also [get a repository subscription](https://developer.github.com/v3/activity/watching/#get-a-repository-subscription).
+**Deprecated:** This method has been renamed to activity.getThreadSubscriptionForAuthenticatedUser
 
-Note that subscriptions are only generated if a user is participating in a conversation--for example, they've replied to the thread, were **@mentioned**, or manually subscribe to a thread.
+Marks all notifications as "read" removes it from the [default view on GitHub](https://github.com/notifications). If the number of notifications is too large to complete in one request, you will receive a `202 Accepted` status and GitHub will run an asynchronous process to mark notifications as "read." To check whether any "unread" notifications remain, you can use the [List notifications for the authenticated user](https://developer.github.com/v3/activity/notifications/#list-notifications-for-the-authenticated-user) endpoint and pass the query parameter `all=false`.
 
 ```js
-octokit.activity.getThreadSubscription({
-  thread_id,
-});
+octokit.activity.getThreadSubscription();
 ```
 
 ## Parameters
@@ -21,12 +19,12 @@ octokit.activity.getThreadSubscription({
     </tr>
   </thead>
   <tbody>
-    <tr><td>thread_id</td><td>yes</td><td>
+    <tr><td>last_read_at</td><td>no</td><td>
 
-thread_id parameter
+Describes the last point that notifications were checked. Anything updated since this time will not be marked as read. If you omit this parameter, all notifications are marked as read. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`. Default: The current timestamp.
 
 </td></tr>
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/notifications/#get-a-thread-subscription).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/notifications/#mark-notifications-as-read).

docs/activity/getThreadSubscriptionForAuthenticatedUser.md

@@ -0,0 +1,32 @@
+# Get a thread subscription for the authenticated user
+
+This checks to see if the current user is subscribed to a thread. You can also [get a repository subscription](https://developer.github.com/v3/activity/watching/#get-a-repository-subscription).
+
+Note that subscriptions are only generated if a user is participating in a conversation--for example, they've replied to the thread, were **@mentioned**, or manually subscribe to a thread.
+
+```js
+octokit.activity.getThreadSubscriptionForAuthenticatedUser({
+  thread_id,
+});
+```
+
+## Parameters
+
+<table>
+  <thead>
+    <tr>
+      <th>name</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>thread_id</td><td>yes</td><td>
+
+thread_id parameter
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/notifications/#get-a-thread-subscription-for-the-authenticated-user).

docs/activity/listEventsForAuthenticatedUser.md

@@ -0,0 +1,40 @@
+# List events for the authenticated user
+
+If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
+
+```js
+octokit.activity.listEventsForAuthenticatedUser({
+  username,
+});
+```
+
+## Parameters
+
+<table>
+  <thead>
+    <tr>
+      <th>name</th>
+      <th>required</th>
+      <th>description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr><td>username</td><td>yes</td><td>
+
+username parameter
+
+</td></tr>
+<tr><td>per_page</td><td>no</td><td>
+
+Results per page (max 100)
+
+</td></tr>
+<tr><td>page</td><td>no</td><td>
+
+Page number of the results to fetch.
+
+</td></tr>
+  </tbody>
+</table>
+
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/events/#list-events-for-the-authenticated-user).

docs/activity/listEventsForOrg.md

@@ -1,4 +1,6 @@
-# List events for an organization
+# List organization events for the authenticated user
+
+**Deprecated:** This method has been renamed to activity.listOrgEventsForAuthenticatedUser
 
 This is the user's organization dashboard. You must be authenticated as the user to view this.
 
@@ -43,4 +45,4 @@ Page number of the results to fetch.
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/events/#list-events-for-an-organization).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/events/#list-organization-events-for-the-authenticated-user).

docs/activity/listEventsForUser.md

@@ -1,4 +1,6 @@
-# List events performed by a user
+# List events for the authenticated user
+
+**Deprecated:** This method has been renamed to activity.listEventsForAuthenticatedUser
 
 If you are authenticated as the given user, you will see your private events. Otherwise, you'll only see public events.
 
@@ -37,4 +39,4 @@ Page number of the results to fetch.
   </tbody>
 </table>
 
-See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/events/#list-events-performed-by-a-user).
+See also: [GitHub Developer Guide documentation](https://developer.github.com/v3/activity/events/#list-events-for-the-authenticated-user).