first cut at whatsnew-1.8

1 files changed, 28 insertions, 26 deletions

diff --git a/CHANGES.txt b/CHANGES.txt
index 8f6e5b37a..c7d40a37a 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -4,25 +4,25 @@ unreleased
 Backward Incompatibilities
 --------------------------
 
- - Support for the ``IContextURL`` interface that was deprecated in Pyramid 1.3
-   has been removed.  See https://github.com/Pylons/pyramid/pull/2822
+- Support for the ``IContextURL`` interface that was deprecated in Pyramid 1.3
+  has been removed.  See https://github.com/Pylons/pyramid/pull/2822
 
- - Following the Pyramid deprecation period (1.6 -> 1.8),
-   daemon support for pserve has been removed. This includes removing the
-   daemon commands (start, stop, restart, status) as well as the following
-   arguments:
-   --daemon --pid-file --log-file --monitor-restart --status --user --group
-   --stop-daemon
+- Following the Pyramid deprecation period (1.6 -> 1.8),
+  daemon support for pserve has been removed. This includes removing the
+  daemon commands (start, stop, restart, status) as well as the following
+  arguments: ``--daemon``, ``--pid-file``, ``--log-file``,
+  ``--monitor-restart``, ``--status``, ``--user``, ``--group``,
+  ``--stop-daemon``
 
-   To run your server as a daemon you should use a process manager instead of
-   pserve.
+  To run your server as a daemon you should use a process manager instead of
+  pserve.
 
-   See https://github.com/Pylons/pyramid/pull/2615
+  See https://github.com/Pylons/pyramid/pull/2615
 
-- ``pcreate`` is now interactive by default. You will be prompted if
-  a file already exists with different content. Previously if there were
-  similar files it would silently skip them unless you specified
-  ``--interactive`` or ``--overwrite``.
+- ``pcreate`` is now interactive by default. You will be prompted if a file
+  already exists with different content. Previously if there were similar
+  files it would silently skip them unless you specified ``--interactive``
+  or ``--overwrite``.
   See https://github.com/Pylons/pyramid/pull/2775
 
 - Removed undocumented argument ``cachebust_match`` from
@@ -48,13 +48,13 @@ Features
 - Python 3.6 compatibility.
   https://github.com/Pylons/pyramid/issues/2835
 
-- pcreate learned about --package-name to allow you to create a new project in
-  an existing folder with a different package name than the project name. See
-  https://github.com/Pylons/pyramid/pull/2783
+- pcreate learned about ``--package-name`` to allow you to create a new project
+  in an existing folder with a different package name than the project name.
+  See https://github.com/Pylons/pyramid/pull/2783
 
-- The `_get_credentials` private method of `BasicAuthAuthenticationPolicy`
-  has been extracted into standalone function ``extract_http_basic_credentials`
-  in `pyramid.authentication` module, this function extracts HTTP Basic
+- The ``_get_credentials`` private method of ``BasicAuthAuthenticationPolicy``
+  has been extracted into standalone function ``extract_http_basic_credentials``
+  in ``pyramid.authentication`` module, this function extracts HTTP Basic
   credentials from a ``request`` object, and returns them as a named tuple.
   See https://github.com/Pylons/pyramid/pull/2662
 
@@ -143,8 +143,8 @@ Features
 Bug Fixes
 ---------
 
-- Fixed bug in `proutes` such that it now shows the correct view when a class
-  and `attr` is involved.
+- Fixed bug in ``proutes`` such that it now shows the correct view when a
+  class and ``attr`` is involved.
   See: https://github.com/Pylons/pyramid/pull/2687
 
 - Fix a ``FutureWarning`` in Python 3.5 when using ``re.split`` on the
@@ -179,13 +179,15 @@ Deprecations
 
 Documentation Changes
 ---------------------
+
 - Replace Typographical Conventions with an enhanced Style Guide.
   https://github.com/Pylons/pyramid/pull/2838
 
-- Add pyramid_nacl_session to session factories.
-  See https://github.com/Pylons/pyramid/issues/2791
+- Add `pyramid_nacl_session
+  <http://docs.pylonsproject.org/projects/pyramid-nacl-session/en/latest/>`_
+  to session factories. See https://github.com/Pylons/pyramid/issues/2791
 
-- Update HACKING.txt from stale branch that was never merged to master.
+- Update ``HACKING.txt`` from stale branch that was never merged to master.
   See https://github.com/Pylons/pyramid/pull/2782
 
 - Updated Windows installation instructions and related bits.