Apply suggestions from code review

Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
ncoghlan · Oct 8, 2024 · Jun 30, 2018 · Jun 30, 2018 · Jun 30, 2018 · Jun 30, 2018
commit aad97ee24a76f70fc5d399aff612a2e9c1207bf3
diff --git a/Misc/NEWS.d/next/Documentation/2018-07-04-20-35-25.bpo-34008.bqecIb.rst b/Misc/NEWS.d/next/Documentation/2018-07-04-20-35-25.bpo-34008.bqecIb.rst
@@ -1,8 +1,8 @@
-The ``Py_Main`` documentation moved from the "Very High Level API" section to the
+The :c:func:`Py_Main` documentation moved from the "Very High Level API" section to the
 "Initialization and Finalization" section.
 
 Also make it explicit that we expect ``Py_Main`` to typically be called instead
 of ``Py_Initialize`` rather than after it (since ``Py_Main`` makes its own
-call to ``Py_Initialize``). However, also document that calling both is
-supported, but it's version dependent as to exactly which settings
-will be applied correctly in that case.
+call to ``Py_Initialize``). Document that calling both is
+supported but is version dependent on which settings
+will be applied correctly.