Address review comments

Finish the next_network() docstring: a period on the argument sentence
and a Raises section for the two ValueError cases.

Build the result from an (address, prefix) tuple rather than formatting
and reparsing a string.

Give the What's New and NEWS entries explicit link titles so the
IPv4Network and IPv6Network methods no longer both render as
next_network().

Author: fedonman

Doc/whatsnew/3.16.rst

@@ -412,9 +412,9 @@ io
 ipaddress
 ---------
 
-* Add :meth:`~ipaddress.IPv4Network.next_network` and
-  :meth:`~ipaddress.IPv6Network.next_network` methods to find the next nearest
-  network with a specific prefix size.
+* Add :meth:`IPv4Network.next_network() <ipaddress.IPv4Network.next_network>`
+  and :meth:`IPv6Network.next_network() <ipaddress.IPv6Network.next_network>`
+  methods to find the next nearest network with a specific prefix size.
   (Contributed by Faisal Mahmood in :gh:`87027`.)
 
 

Lib/ipaddress.py

@@ -1124,11 +1124,15 @@ def next_network(self, next_prefix=None):
 
         Args:
             next_prefix: The desired next prefix length, if not specified the
-            same self.prefixlen will be used
+            same self.prefixlen will be used.
 
         Returns:
             An IPv(4|6) Network object of the next closest network.
 
+        Raises:
+            ValueError: If next_prefix is outside the range of valid prefix
+            lengths, or if no further network of that size exists.
+
         """
         if next_prefix is None:
             next_prefix = self.prefixlen
@@ -1156,9 +1160,7 @@ def next_network(self, next_prefix=None):
                 "network"
             )
 
-        return self.__class__(
-            f"{self._string_from_ip_int(next_ip)}/{next_prefix}"
-        )
+        return self.__class__((next_ip, next_prefix))
 
 
 class _BaseConstants:

Misc/NEWS.d/next/Library/2021-01-09-18-40-15.bpo-42861.T7Ge9O.rst

@@ -1,2 +1,3 @@
-Add :meth:`~ipaddress.IPv4Network.next_network` and
-:meth:`~ipaddress.IPv6Network.next_network`.  Patch by Faisal Mahmood.
+Add :meth:`IPv4Network.next_network() <ipaddress.IPv4Network.next_network>`
+and :meth:`IPv6Network.next_network() <ipaddress.IPv6Network.next_network>`.
+Patch by Faisal Mahmood.