pythonthings
diff --git a/‎LATEST_VERSION_NOTES.rst
Lines changed: 29 additions & 2 deletions b/‎LATEST_VERSION_NOTES.rst
Lines changed: 29 additions & 2 deletions
diff --git a/‎github3/github.py
Lines changed: 5 additions & 3 deletions b/‎github3/github.py
Lines changed: 5 additions & 3 deletions
@@ -3,11 +3,38 @@
 Unreleased
 ~~~~~~~~~~
 
+Breaking Changes (since 1.0.0a4)
+````````````````````````````````
+
+- Remove ``Thread.comment``, ``Thread.thread``, ``Thread.urls`` attributes.
+
+- Remove ``Thread#is_unread`` method. Use the ``Thread.unread`` attribute
+  instead.
+
+- ``Subscription`` has been split into two objects: ``ThreadSubscription`` and
+  ``RepositorySubscription`` with the same methods.
+
+- Remove ``is_ignored`` method from our Subscription objects. Use the
+  ``ignored`` attribute instead.
+
+- Remove ``is_subscribed`` method from our Subscription objects. Use the
+  ``subscribed`` attribute instead.
+
+Features Added (since 1.0.0a4)
+``````````````````````````````
+
 - Add ``Organization#all_events``.
-- Deprecate ``Organization#events`` in favor of ``Organization#public_events``.
-- Fix test failtures on windows caused by unclosed file handles.
+
 - Add ``Tag.tagger_as_User`` which attempts to return the tagger as as User.
+
 - Add ``Repo.statuses`` and a corresponding ``repo.status.CombinedStatus`` to
+
+Deprecations and Other Changes (since 1.0.0a4)
+``````````````````````````````````````````````
+
+- Deprecate ``Organization#events`` in favor of ``Organization#public_events``.
+
+- Fix test failtures on windows caused by unclosed file handles.
   get a combined view of commit statuses for a given ref.
 
 1.0.0a4: 2016-02-19
 
@@ -24,9 +24,9 @@
 from .search import (CodeSearchResult, IssueSearchResult,
                      RepositorySearchResult, UserSearchResult)
 from .structs import SearchIterator
+from . import notifications
 from . import orgs
 from . import users
-from .notifications import Thread
 from .licenses import License
 from uritemplate import URITemplate
 
@@ -870,7 +870,7 @@ def notifications(self, all=False, participating=False, number=-1,
         :param str etag: (optional), ETag from a previous request to the same
             endpoint
         :returns: generator of
-            :class:`Thread <github3.notifications.Thread>`
+            :class:`~github3.notifications.Thread`
         """
         params = None
         if all is True:
@@ -879,7 +879,9 @@ def notifications(self, all=False, participating=False, number=-1,
             params = {'participating': 'true'}
 
         url = self._build_url('notifications')
-        return self._iter(int(number), url, Thread, params, etag=etag)
+        return self._iter(
+            int(number), url, notifications.Thread, params, etag=etag
+        )
 
     def octocat(self, say=None):
         """Returns an easter egg of the API.