Simply sentences by adding hyperlinks

1 files changed, 6 insertions, 2 deletions

diff --git a/docs/narr/startup.rst b/docs/narr/startup.rst
index f740baadf..6c5fe8f60 100644
--- a/docs/narr/startup.rst
+++ b/docs/narr/startup.rst
@@ -47,10 +47,14 @@ Here's a high-level time-ordered overview of what happens when you press
    the :term:`PasteDeploy` library and returns a parser that can understand
    the format.
 
+.. _ini_section_discovery:
+
 #. The :term:`PasteDeploy` finds a section named either ``[app:main]``,
    ``[pipeline:main]``, or ``[composite:main]`` in the ``.ini`` file.
    This section becomes the ``ini`` section for the :term:`WSGI` webserver portion of your application -- the part ``Pyramid`` was built to help with.
 
+   .. _entry_point_discovery:
+
    If you're using a simple application (e.g., ``[app:main]``), the
    application's ``paste.app_factory`` :term:`entry point` will be named on the
    ``use=`` line within the section's configuration.  If instead of a simple
@@ -68,8 +72,8 @@ Here's a high-level time-ordered overview of what happens when you press
    file and uses it to configure the Python standard library logging system for
    this application.  See :ref:`logging_config` for more information.
 
-#. The application's *constructor* is named by the entry point referenced on the ``use=`` line of the ``ini`` section which configures your :app:`Pyramid` application.
-   It is passed the key/value parameters mentioned within the this section.
+#. The application's entry point :ref:`found above <entry_point_discovery>`, usually the entry point referenced on the above mentioned ``use=`` line, is the application's *constructor*.
+   It is passed the key/value parameters in :ref:`the application's .ini section <ini_section_discovery>`.
    The constructor is meant to return a :term:`router` instance, which is a :term:`WSGI` application.
 
    For :app:`Pyramid` applications, the constructor will be a function named