Fix a number of links

boards/beagleboard/index.rst

+.. _beagleboard-boards-home:
+
 BeagleBoard (all)
 ###################
 

boards/beaglebone/index.rst

-.. _beaglebone-blue-home::
+.. _beaglebone-all-home:
 
 BeagleBone (all)
 ###################

boards/capes/index.rst

+.. _capes:
+
 Capes
 #####
 

boards/index.rst

+.. _boards:
+
 Boards
 ######
 
-`BeagleBone <beaglebone>`__ is a family of ARM-based, Linux-capable boards intended to be
+:ref:`BeagleBone <beaglebone-all-home>` is a family of ARM-based, Linux-capable boards intended to be
 bare-bones, with a balance of features to enable rapid prototyping and provide a solid
 reference for building end products.
 
-`PocketBeagle <pocketbeagle>`__ boards are ultra-tiny ARM-based, Linux-capable boards intended to be
+:ref:`pocketbeagle-home` boards are ultra-tiny ARM-based, Linux-capable boards intended to be
 very low cost, with minimal features suitable for beginners and attractive to professionals
 looking for a more minimal starting point.
 
-`BeagleBone and PocketBeagle Capes <capes>`__ are add-on boards for BeagleBone and PocketBeagle boards.
+BeagleBone and PocketBeagle :ref:`capes` are add-on boards for BeagleBone and PocketBeagle boards.
 
-`BeagleConnect <beagleconnect>`__ boards are ARM microcontroller-based, Zephyr-capable boards meant
+:ref:`beagleconnect-home` boards are ARM microcontroller-based, Zephyr-capable boards meant
 to act as ultra low cost smart peripherals to their Linux-capable counterparts, with connectivity
 options that enable almost endless sensing and actuation expansion.
 
-`BeagleBoard <beagleboard>`__ is a family of ARM-based, Linux-capable boards where this project
+:ref:`BeagleBoard <beagleboard-boards-home>` is a family of ARM-based, Linux-capable boards where this project
 started.
 
 .. toctree::

books/index.rst

+.. _books-home:
+
 Books
 *****
 

index.rst

@@ -17,10 +17,10 @@ Welcome to the `BeagleBoard project documentation <https://git.beagleboard.org/d
 Introduction
 ************
 
-Get started by `engaging the BealgeBoard.org developer community </intro/>`__.
+Get started engaging the BeagleBoard.org developer community by reading our :ref:`introduction` page.
 
-* Read about how to: `get started and get help </intro/support>`__
-* Learn how to: `contribute to the project </intro/contribution>`__
+* Read about how to get started and get help on our :ref:`support` page.
+* Learn how to contribute to the project on our :ref:`contribution` page.
 
 .. toctree::
    :maxdepth: 2
@@ -42,9 +42,9 @@ design, including the
 `materials <https://git.beagleboard.org/explore/projects/topics/boards>`__ to modify the designs
 from source using appropriate design tools.
 
-* Check out our most popular board at: `BeagleBone Black </boards/beaglebone/black>`__
-* Check out our latest board at: `BeagleBone AI-64 </boards/beaglebone/ai-64>`__
-* Find all of our on: `our boards page </boards/index>`__
+* Check out our most popular board at: :ref:`beagleboneblack-home`
+* Check out our latest board at: :ref:`bbai64-home`
+* Find all of our on: :ref:`boards`
 
 .. grid:: 1 1 1 2
    :margin: 4 4 0 0
@@ -322,11 +322,10 @@ developers. Some developers choose to host documentation for their projects `her
 Books
 *****
 
-This project hosts a
-`collection of open-source books written to help Beagle developers </books/index>`__.
+This project hosts a collection of open-source :ref:`books-home` books written to help Beagle developers.
 
-* Find a great introduction to BeagleBone at: `BeagleBone Cookbook </books/beaglebone-cookbook>`__
-* Learn one of the most amazing Beagle features at: `PRU Cookbook </books/pru-cookbook>`__
+* Find a great introduction to BeagleBone at: :ref:`bone-cook-book-home`
+* Learn one of the most amazing Beagle features at: :ref:`pru-cookbook-home`
 
 .. toctree::
    :maxdepth: 1

intro/contribution/index.rst

-.. _beagleboard-contributoin:
+.. _contribution:
 
 Contribution 
 ###############

intro/index.rst

+.. _introduction:
+
 Introduction
 #############
 
 Welcome to the BeagleBoard documentation project. If you are looking for help with your Beagle
 open-hardware development platform, you've found the right place!
 
-Please check out our `Support Page <support>`__ to find out how to get started, resolve issues,
+Please check out our :ref:`support` page` to find out how to get started, resolve issues,
 and engage the developer community.
 
 Don't forget that this is an open-source project! Your contributions are welcome. Learn about how
 to contribute to the BeagleBoard documentation project and any of the many open-source Beagle
-projects on-going on our `Contribution Page <contribution>`__.
+projects on-going on our :ref:`contribution` page.
 
 .. toctree::
    :maxdepth: 2