diff --git a/docs/source/index.rst b/docs/source/index.rst
index f2c06d49..707647b1 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -4,9 +4,10 @@ Welcome to HackRF's documentation!
 
 .. toctree::
    :maxdepth: 2
-   :caption: HackRF User Documentation
+   :caption: User Documentation
 
    hackrf_one
+   jawbreaker   
    faq
    troubleshooting
    getting_help
@@ -55,9 +56,4 @@ Welcome to HackRF's documentation!
    opera_cake_board_addressing
    opera_cake_port_configuration
    opera_cake_modes_of_operation
-
-.. toctree::
-   :maxdepth: 2
-   :caption: Jawbreaker Documentation
-
-   jawbreaker      
\ No newline at end of file
+        
\ No newline at end of file
diff --git a/docs/source/opera_cake_modes_of_operation.rst b/docs/source/opera_cake_modes_of_operation.rst
index a73349e5..3af826e8 100644
--- a/docs/source/opera_cake_modes_of_operation.rst
+++ b/docs/source/opera_cake_modes_of_operation.rst
@@ -7,7 +7,7 @@ Opera Cake supports three modes of operation: ``manual``, ``frequency``, and ``t
 Manual Mode
 ~~~~~~~~~~~
 
-The default mode of operation is ``manual``. In manual mode, fixed port connections are configured with the ``-a`` and ``-b`` options as in the port configuration examples above. If the operating mode has been changed, it can be changed back to manual mode with:
+The default mode of operation is ``manual``. In manual mode, fixed port connections are configured with the ``-a`` and ``-b`` options as in the :ref:`port configuration examples <portconfiguration>`. If the operating mode has been changed, it can be changed back to manual mode with:
 
 .. code-block:: sh
 
diff --git a/docs/source/opera_cake_port_configuration.rst b/docs/source/opera_cake_port_configuration.rst
index 8ce36016..9a7d6b48 100644
--- a/docs/source/opera_cake_port_configuration.rst
+++ b/docs/source/opera_cake_port_configuration.rst
@@ -1,3 +1,5 @@
+.. _portconfiguration:
+
 ===================
 Port Configurations
 ===================