From c6976953d4d3e26655bc0b7499eab268b637aa00 Mon Sep 17 00:00:00 2001
From: Deepak Khatri <lorforlinux@beagleboard.org>
Date: Wed, 6 Jul 2022 04:15:21 +0530
Subject: [PATCH] Update getting started

---
 index-tex.rst               |   1 +
 index.rst                   |   1 +
 support/getting-started.rst | 495 +++++++++++++++---------------------
 3 files changed, 206 insertions(+), 291 deletions(-)

diff --git a/index-tex.rst b/index-tex.rst
index 2a301eab..7cc79e09 100644
--- a/index-tex.rst
+++ b/index-tex.rst
@@ -11,5 +11,6 @@ BeagleBoard Docs
 
 .. toctree::
    support/index.rst
+   support/getting-started.rst
    beaglebone-black/index.rst
    beaglebone-ai-64/index.rst
\ No newline at end of file
diff --git a/index.rst b/index.rst
index 67928e42..63408c13 100644
--- a/index.rst
+++ b/index.rst
@@ -14,6 +14,7 @@ Sections
    :caption: Support
 
    support/index.rst
+   support/getting-started.rst
 
 .. toctree::
    :maxdepth: 1
diff --git a/support/getting-started.rst b/support/getting-started.rst
index e62d11de..e8cfd5bb 100644
--- a/support/getting-started.rst
+++ b/support/getting-started.rst
@@ -1,349 +1,262 @@
-Getting Started
-===============
+.. _beagleboard-getting-started:
 
-Beagles are tiny computers ideal for learning and prototyping with
-electronics. Read the step-by-step getting started tutorial below to
-begin developing with your Beagle in minutes.
+Getting Started
+##################
 
-.. _update:
+Beagles are tiny computers ideal for learning and prototyping with electronics. 
+Read the step-by-step getting started tutorial below to begin developing with your Beagle in minutes.
 
 Update board with latest software
-=================================
+------------------------------------
 
-This step may or may not be necessary, depending on how old a software
-image you already have, but executing this, the longest, step will
-ensure the rest will go as smooth as possible.
+This step may or may not be necessary, depending on how old a software image you already have, 
+but executing this, the longest, step will ensure the rest will go as smooth as possible.
 
-Step #0.A: Download the latest software image
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Download the latest software image
+********************************************
+Download the lastest Debian image from `beagleboard.org/latest-images <https://beagleboard.org/latest-images>`_. 
+The "IoT" images provide more free disk space if you don't need to use a graphical user interface (GUI). 
 
-Download the lastest Debian image from
-`beagleboard.org/latest-images <https://beagleboard.org/latest-images>`__.
-The "IoT" images provide more free disk space if you don't need to use a
-graphical user interface (GUI).
+.. NOTE:: 
+	Due to sizing necessities, this download may take 30 minutes or more. 
 
-Note: Due to sizing necessities, this download may take 30 minutes or
-more.
-
-The Debian distribution is provied for the boards. The file you download
-will have an .img.xz extension. This is a compressed sector-by-sector
-image of the SD card.
+The Debian distribution is provied for the boards. The file you download will have an .img.xz extension. 
+This is a compressed sector-by-sector image of the SD card.
 
 |image0|
 
-Step #0.B: Install SD card programming utility
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Download and install `balenaEtcher <https://www.balena.io/etcher/>`__.
+Install SD card programming utility
+*********************************************
+Download and install `balenaEtcher <https://www.balena.io/etcher/>`_.
 
-| |image1|
-| |image2|
+|image1|
+|image2|
 
-Step #0.C: Connect SD card to your computer
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Connect SD card to your computer
+*******************************************
 
-Use your computer's SD slot or a USB adapter to connect the SD card to
-your computer.
+Use your computer's SD slot or a USB adapter to connect the SD card to your computer.
 
-Step #0.D: Write the image to your SD card
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Write the image to your SD card
+*****************************************
 
-Use Etcher to write the image to your SD card. Etcher will transparently
-decompress the image on-the-fly before writing it to the SD card.
+Use Etcher to write the image to your SD card. Etcher will transparently decompress the 
+image on-the-fly before writing it to the SD card.
 
 |image3|
 
-Step #0.E: Eject the SD card
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
+Eject the SD card
+****************************
 Eject the newly programmed SD card.
 
-Step #0.F: Boot your board off of the SD card
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Insert SD card into your (powered-down) board, hold down the USER/BOOT
-button (if using Black) and apply power, either by the USB cable or 5V
-adapter.
-
-If using an original BeagleBone or PocketBeagle, you are done.
-
-If using BeagleBone Black, BeagleBone Blue, BeagleBone AI or other board
-with on-board eMMC flash and you desire to write the image to your
-on-board eMMC, you'll need to follow the instructions at
-http://elinux.org/Beagleboard:BeagleBoneBlack_Debian#Flashing_eMMC. When
-the flashing is complete, all 4 USRx LEDs will be steady on or off. The
-latest Debian flasher images automatically power down the board upon
-completion. *This can take up to 45 minutes.* Power-down your board,
-*remove the SD card* and apply power again to finish.
+Boot your board off of the SD card
+********************************************
+Insert SD card into your (powered-down) board, hold down the USER/BOOT button (if using Black) 
+and apply power, either by the USB cable or 5V adapter. 
+	
+If using an original BeagleBone or PocketBeagle, you are done. 
+	
+If using BeagleBone Black, BeagleBone Blue, BeagleBone AI or other board with on-board eMMC 
+flash and you desire to write the image to your on-board eMMC, you'll need to follow the 
+instructions at http://elinux.org/Beagleboard:BeagleBoneBlack_Debian#Flashing_eMMC. 
+When the flashing is complete, all 4 USRx LEDs will be steady on or off. The latest Debian 
+flasher images automatically power down the board upon completion. This can take up to 45 minutes. 
+Power-down your board, remove the SD card and apply power again to finish.
 
 Start your Beagle
-=================
-
-*If any step fails, it is recommended to update to the*\ `latest software image <#update>`__\ *using the instructions above.*
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-|image4| **Power and boot**
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. container::
-
-   Most Beagles include a USB cable, providing a convenient way to
-   provide both power to your Beagle and connectivity to your computer.
-   If you provide your own, ensure it is of good quality.
-
-   Alternatively, your Beagle may have a barrel jack. The voltage should
-   be 5V except for BeagleBoard-X15 and BeagleBone Blue which use 12V.
-
-   *Note that BeagleBoard-X15 must always be powered by a 12V adapter
-   with a barrel jack.*
-   If you are using your Beagle with an `SD (microSD)
-   card <https://en.wikipedia.org/wiki/Secure_Digital>`__, make sure it
-   is inserted ahead of providing power. Most Beagles include programmed
-   on-board flash and therefore do not require an SD card to be
-   inserted.
-
-   You'll see the power (PWR or ON) LED lit steadily. Within a minute or
-   so, you should see the other LEDs blinking in their default
-   configurations. Consult the Quick Start Guide (QSG) or System
-   Reference Manual (SRM) for your board to locate these LEDs.
-
-   -  USR0 is typically configured at boot to blink in a heartbeat
-      pattern
-   -  USR1 is typically configured at boot to light during SD (microSD)
-      card accesses
-   -  USR2 is typically configured at boot to light during CPU activity
-   -  USR3 is typically configured at boot to light during eMMC accesses
-   -  USR4/WIFI is typically configured at boot to light with WiFi
-      (client) network association (*BeagleBone Blue and BeagleBone AI
-      only*)
-
-|image5|\ **Enable a network connection**
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If connected via USB, a network adapter should show up on your computer.
-Your Beagle should be running a DHCP server that will provide your
-computer with an IP address of either 192.168.7.1 or 192.168.6.1,
-depending on the type of USB network adapter supported by your
-computer's operating system. Your Beagle will reserve 192.168.7.2 or
-192.168.6.2 for itself.
-
-If your Beagle includes WiFi, an access point called "BeagleBone-XXXX"
-where "XXXX" varies between boards. The access point password defaults
-to "BeagleBone". Your Beagle should be running a DHCP server that will
-provide your computer with an IP address in the 192.168.8.x range and
-reserve 192.168.8.1 for itself.
-
-If your Beagle is connected to your local area network (LAN) via either
-Ethernet or WiFi, it will utilize
-`mDNS <https://en.wikipedia.org/wiki/Multicast_DNS>`__ to broadcast
-itself to your computer. If your computer supports mDNS, you should see
-your Beagle as beaglebone.local. *Non-BeagleBone boards will utilize
-alternate names. Multiple BeagleBone boards on the same network will add
-a suffix such as beaglebone-2.local.*
-
-The below table summarizes the typical addresses and should dynamically
-update to indicate an active connection.</>
-
-Note: You must "load unsafe scripts" or load\ `this
-page <http://beagleboard.org/getting-started>`__\ without HTTPS security
-for the automatic detection to work.
-
-================== =============== =================== ========
-IP Address         Connection Type Operating System(s) Status
-================== =============== =================== ========
-192.168.7.2        USB             Windows             Inactive
-192.168.6.2        USB             Mac OS X, Linux     Inactive
-192.168.8.1        WiFi            all                 Inactive
-beaglebone.local   all             mDNS enabled        Inactive
-beaglebone-2.local all             mDNS enabled        Inactive
-================== =============== =================== ========
-
-|image6|\ **Browse to your Beagle**
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Using either `Chrome <https://www.google.com/chrome>`__ or
-`Firefox <http://www.mozilla.org/firefox>`__ (Internet Explorer will
-**NOT** work), browse to the web server running on your board. It will
-load a presentation showing you the capabilities of the board. Use the
-arrow keys on your keyboard to navigate the presentation.
-
--  Click here to launch: http://192.168.7.2
-   Older software images require you to EJECT the BEAGLE_BONE drive to
-   start the network. With the latest software image, that step is no
-   longer required.
-
-|image7|
-
-Troubleshooting
----------------
-
-*Do not use Internet Explorer.*
-
-Virtual machines are not recommended when using the direct USB
-connection. It is recommended you use only network connections to your
-board if you are using a virtual machine.
-
-When using 'ssh' with the provided image, the username is 'debian' and
-the password is 'temppwd'.
-
-With the latest images, *it should no longer be necessary to install
-drivers* for your operating system to give you network-over-USB access
-to your Beagle. In case you are running an older image, an older
-operating system or need additional drivers for serial access to older
-boards, links to the old drivers are below.
-
-Operating System
+------------------
+
+If any step fails, it is recommended to update to the 
+`latest software image <https://gitbook.beagleboard.org/support/getting-started>`_ 
+using the instructions above.
+
+Power and boot
+----------------
+
+Most Beagles include a USB cable, providing a convenient way to provide both power to your 
+Beagle and connectivity to your computer. If you provide your own, ensure it is of good quality.
+
+Alternatively, your Beagle may have a barrel jack. The voltage should be 5V except for 
+BeagleBoard-X15 and BeagleBone Blue which use 12V.
+
+.. Note::
+	BeagleBoard-X15 must always be powered by a 12V adapter with a barrel jack.
+
+If you are using your Beagle with an `SD (microSD) card <https://en.wikipedia.org/wiki/Secure_Digital>`_, make sure it is inserted ahead of providing power. 
+Most Beagles include programmed on-board flash and therefore do not require an SD card to be inserted.
+
+You'll see the power (PWR or ON) LED lit steadily. Within a minute or so, you should see the other LEDs 
+blinking in their default configurations. Consult the Quick Start Guide (QSG) or System Reference 
+Manual (SRM) for your board to locate these LEDs.
+
+- USR0 is typically configured at boot to blink in a heartbeat pattern.
+- USR1 is typically configured at boot to light during SD (microSD) card accesses.
+- USR2 is typically configured at boot to light during CPU activity.
+- USR3 is typically configured at boot to light during eMMC accesses.
+- USR4/WIFI is typically configured at boot to light with WiFi (client) network association (BeagleBone Blue and BeagleBone AI only).
+
+Enable a network connection
+----------------------------
+
+If connected via USB, a network adapter should show up on your computer. 
+Your Beagle should be running a DHCP server that will provide your computer 
+with an IP address of either 192.168.7.1 or 192.168.6.1, depending on the 
+type of USB network adapter supported by your computer's operating system. 
+Your Beagle will reserve 192.168.7.2 or 192.168.6.2 for itself.
+
+If your Beagle includes WiFi, an access point called "BeagleBone-XXXX" where "XXXX" 
+varies between boards. The access point password defaults to "BeagleBone". 
+Your Beagle should be running a DHCP server that will provide your computer 
+with an IP address in the 192.168.8.x range and reserve 192.168.8.1 for itself.
+
+If your Beagle is connected to your local area network (LAN) via either Ethernet or WiFi, 
+it will utilize `mDNS <https://en.wikipedia.org/wiki/Multicast_DNS>`_ to broadcast itself 
+to your computer. If your computer supports mDNS, you should see your Beagle as beaglebone.local. 
+Non-BeagleBone boards will utilize alternate names. Multiple BeagleBone boards on the same 
+network will add a suffix such as beaglebone-2.local.
+
+The below table summarizes the typical addresses and should dynamically update to indicate an active connection.
+
+.. Note::
+	You must "load unsafe scripts" or load `this page <http://beagleboard.org/getting-started>`_ 
+	without HTTPS security for the automatic detection to work.
+
+.. list-table::
+    :header-rows: 1
+
+    * - List table
+      - Connection type
+      - Operating System(s)
+      - Status
+    * - 192.168.7.2
+      - USB
+      - Windows
+      - Inactive
+    * - 192.168.6.2
+      - USB
+      - Mac OS X, Linux
+      - Inactive
+    * - 192.168.8.1
+      - WiFi
+      - all
+      - Inactive
+    * - beaglebone.local
+      - all
+      - mDNS enabled
+      - Inactive
+    * - beaglebone-2.local
+      - all
+      - mDNS enabled
+      - Inactive
+
+Browse to your beagle
+----------------------
 
-USB Drivers
+Use either `Firefox <http://www.mozilla.org/firefox>`_ or `Chrome <https://www.google.com/chrome>`_ 
+(Internet Explorer will NOT work), browse to the web server running on your board. It will load a presentation 
+showing you the capabilities of the board. Use the arrow keys on your keyboard to navigate the presentation.
 
-Comments
+Click here to launch: https://192.168.7.2 Older software images require you to EJECT the BEAGLE_BONE 
+drive to start the network. With the latest software image, that step is no longer required.
 
-Windows (64-bit)
+Troubleshooting
+------------------
 
-`64-bit
-installer <https://beagleboard.org/static/Drivers/Windows/BONE_D64.exe>`__
+Do not use Internet Explorer.
 
-If in doubt, try the 64-bit installer first.
+Virtual machines are not recommended when using the direct USB connection. 
+It is recommended you use only network connections to your board if you are using a virtual machine.
 
--  **Note #1:** Windows Driver Certification warning may pop up two or
-   three times. Click "Ignore", "Install" or "Run"
--  **Note #2:** To check if you're running 32 or 64-bit Windows see
-   this:
-   `support.microsoft.com/kb/827218 <https://support.microsoft.com/kb/827218>`__.
--  **Note #3:** On systems without the latest service release, you may
-   get an error (0xc000007b). In that case, please install the following
-   and retry:
-   `www.microsoft.com/en-us/download/confirmation.aspx?id=13523 <https://www.microsoft.com/en-us/download/confirmation.aspx?id=13523>`__.
--  **Note #4:** You may need to reboot Windows.
--  **Note #5:** These drivers have been tested to work up to Windows 10
+When using 'ssh' with the provided image, the username is 'debian' and the password is 'temppwd'.
 
-Windows (32-bit)
+With the latest images, it should no longer be necessary to install drivers for your operating 
+system to give you network-over-USB access to your Beagle. In case you are running an older image, 
+an older operating system or need additional drivers for serial access to older boards, links to the old drivers are below.
 
-`32-bit
-installer <https://beagleboard.org/static/Drivers/Windows/BONE_DRV.exe>`__
+.. list-table::
+    :header-rows: 1
 
-Mac OS X
+    * - Operating system
+      - USB Driver
+      - Comments
+    * - Windows (64-bit)
+      - `64-bit installer <https://beagleboard.org/static/Drivers/Windows/BONE_D64.exe>`_
+      - If in doubt, try the 64-bit installer first.
+    * - Windows (32-bit)
+      - `32-bit installer <https://beagleboard.org/static/Drivers/Windows/BONE_DRV.exe>`_
+      - 
+    * - Mac OS X
+      - `Network Serial <https://beagleboard.org/static/Drivers/MacOSX/FTDI/EnergiaFTDIDrivers2.2.18.pkg>`_
+      - Install both sets of drivers.
+    * - Linux
+      - `mkudevrules.sh <https://beagleboard.org/static/Drivers/Linux/FTDI/mkudevrule.sh>`_
+      - Driver installation isn't required, but you might find a few udev rules helpful.
 
-| `Network <https://beagleboard.org/static/Drivers/MacOSX/RNDIS/HoRNDIS.pkg>`__
-| `Serial <https://beagleboard.org/static/Drivers/MacOSX/FTDI/EnergiaFTDIDrivers2.2.18.pkg>`__
+.. Note::
+	For Windows (64-bit):
 
-Install both sets of drivers.
+	1. Windows Driver Certification warning may pop up two or three times. Click "Ignore", "Install" or "Run".
+	2. To check if you're running 32 or 64-bit Windows see this:  `support.microsoft.com/kb/827218 <https://support.microsoft.com/kb/827218>`_.
+	3. On systems without the latest service release, you may get an error (0xc000007b). In that case, please install the following and retry: https://www.microsoft.com/en-us/download/confirmation.aspx?id=13523
+	4. You may need to reboot Windows.
+	5. These drivers have been tested to work up to Windows 10
 
-Linux
 
-`mkudevrule.sh <https://beagleboard.org/static/Drivers/Linux/FTDI/mkudevrule.sh>`__
+	Additional FTDI USB to serial/JTAG information and drivers are available from https://www.ftdichip.com/Drivers/VCP.htm
 
-Driver installation isn't required, but you might find a few udev rules
-helpful.
+	Additional USB to virtual Ethernet information and drivers are available from https://www.linux-usb.org/gadget/ and https://joshuawise.com/horndis
 
-**Note:** Additional FTDI USB to serial/JTAG information and drivers are
-available from
-`www.ftdichip.com/Drivers/VCP.htm <https://www.ftdichip.com/Drivers/VCP.htm>`__.
+	Visit https://beagleboard.org/support for additional debugging tips.
 
-**Note:** Additional USB to virtual Ethernet information and drivers are
-available from
-`www.linux-usb.org/gadget/ <https://www.linux-usb.org/gadget/>`__ and
-`joshuawise.com/horndis <https://joshuawise.com/horndis>`__.
+Other currently available software images
+------------------------------------------
 
-Visit `beagleboard.org/support <https://beagleboard.org/support>`__ for
-additional debugging tips.
+Some of the starting images below involve multiple steps to produce an SD card image or otherwise 
+change some of the steps above, so be sure to read all the instructions on their pages. 
+Choose the starting point you want, download or produce the SD card image and follow the steps above.
 
-.. _distros:
+At the time of release, not all of these distributions support BeagleBone Black, but should soon.
 
-Other currently available software images
------------------------------------------
-
-Some of the starting images below involve multiple steps to produce an
-SD card image or otherwise change some of the steps above, so be sure to
-read all the instructions on their pages. Choose the starting point you
-want, download or produce the SD card image and follow the steps above.
-
-At the time of release, not all of these distributions support
-BeagleBone Black, but should soon.
-
--  Texas Instruments releases:
-   `Android <https://beagleboard.org/project/android/>`__,
-   `Linux <https://beagleboard.org/project/amsdk/>`__, `StarterWare (no
-   OS) <https://beagleboard.org/project/starterware/>`__
--  Linux: `Debian <https://beagleboard.org/project/Debian/>`__,
-   `Angstrom Distribution <https://beagleboard.org/project/angstrom>`__,
-   `Ubuntu <https://beagleboard.org/project/ubuntu/>`__,
-   `ArchLinux <https://beagleboard.org/project/AM/>`__,
-   `Gentoo <https://beagleboard.org/project/Gentoo/>`__,
-   `Sabayon <https://beagleboard.org/project/sabayon/>`__,
-   `Buildroot <https://beagleboard.org/project/buildroot/>`__,
-   `Erlang <https://beagleboard.org/project/Nerves/>`__,
-   `Fedora <https://beagleboard.org/project/fedora/>`__
--  Other:
-   `QNX <https://beagleboard.org/project/QNX+Neutrino+on+OMAP/>`__,
-   `FreeBSD <https://beagleboard.org/project/freebsd/>`__
--  `Projects page <https://beagleboard.org/project>`__
-
-.. _hardware:
+- Texas Instruments releases: `Android <https://beagleboard.org/project/android/>`_, `Linux <https://beagleboard.org/project/amsdk/>`_, `StarterWare (no OS) <https://beagleboard.org/project/starterware/>`_
+- Linux: `Debian <https://beagleboard.org/project/Debian/>`_, `Angstrom Distribution <https://beagleboard.org/project/angstrom>`_, `Ubuntu <https://beagleboard.org/project/ubuntu/>`_, `ArchLinux <https://beagleboard.org/project/AM/>`_, `Gentoo <https://beagleboard.org/project/Gentoo/>`_, `Sabayon <https://beagleboard.org/project/sabayon/>`_, `Buildroot <https://beagleboard.org/project/buildroot/>`_, `Erlang <https://beagleboard.org/project/Nerves/>`_, `Fedora <https://beagleboard.org/project/fedora/>`_
+- Other: `QNX <https://beagleboard.org/project/QNX+Neutrino+on+OMAP/>`_, `FreeBSD <https://beagleboard.org/project/freebsd/>`_
+- `Project page<https://beagleboard.org/project>`_
 
 Hardware documentation
-----------------------
+--------------------------
+
+Time to read that manual and check out the design materials: `BeagleBoard <https://github.com/beagleboard/beagleboard>`_, 
+`BeagleBoard-xM <https://github.com/beagleboard/beagleboard-xm>`_, 
+`BeagleBoard-x15 <https://github.com/beagleboard/beagleboard-x15>`_, 
+`BeagleBone <https://github.com/beagleboard/beaglebone>`_, 
+`BeagleBone Black <https://github.com/beagleboard/beaglebone-black>`_,  
+`BeagleBone Black Wireless <https://github.com/beagleboard/beaglebone-black-wireless>`_, 
+`BeagleBone Blue <https://github.com/beagleboard/beaglebone-blue>`_, 
+`PocketBeagle <https://github.com/beagleboard/pocketbeagle>`_, 
+`BeagleBone AI <https://github.com/beagleboard/beaglebone-ai>`_, 
+`BeagleBone AI-64 <https://github.com/beagleboard/beaglebone-ai-64>`_
 
-Time to read that manual and check out the design materials:
-`BeagleBoard <https://github.com/beagleboard/beagleboard>`__,
-`BeagleBoard-xM <https://github.com/beagleboard/beagleboard-xm>`__,
-`BeagleBoard-X15 <https://github.com/beagleboard/beagleboard-x15>`__,
-`BeagleBone <https://github.com/beagleboard/beaglebone>`__, `BeagleBone
-Black <https://github.com/beagleboard/beaglebone-black>`__, `BeagleBone
-Black
-Wireless <https://github.com/beagleboard/beaglebone-black-wireless>`__,
-`BeagleBone Blue <https://github.com/beagleboard/beaglebone-blue>`__,
-`PocketBeagle <https://github.com/beagleboard/pocketbeagle>`__, and
-`BeagleBone AI <https://github.com/beagleboard/beaglebone-ai>`__.
-
-Other links to design materials for various releases can be found at
-`beagleboard.org/hardware/design <https://beagleboard.org/hardware/design>`__.
+Other links to design materials for various releases can be found at https://beagleboard.org/hardware/design
 
 Books
 -----
 
-For a complete list of books on BeagleBone, see
-`beagleboard.org/books <https://beagleboard.org/books>`__.
-
-.. container::
-
-   .. container::
-
-      |image8|
-
-   .. container::
-
-      |image9|
-
-   .. container::
-
-      |image10|
-
-   .. container::
-
-      |image11|
+For a complete list of books on BeagleBone, see `beagleboard.org/books <https://beagleboard.org/books>`_.
 
-`Bad to the Bone <https://bbb.io/bad-to-the-bone>`__
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+`Bad to the Bone <https://bbb.io/bad-to-the-bone>`_
 
-Perfect for high-school seniors or freshman univerisity level text,
-consider using "Bad to the Bone"
+Perfect for high-school seniors or freshman univerisity level text, consider using "Bad to the Bone"
 
-`BeagleBone Cookbook <https://bbb.io/cookbook>`__
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+`BeagleBone Cookbook <https://bbb.io/cookbook>`_
 
-A lighter treatment suitable for a bit broader audience without the
-backgrounders on programming and electronics, consider "BeagleBone
-Cookbook"
+A lighter treatment suitable for a bit broader audience without the backgrounders on programming and 
+electronics, consider "BeagleBone Cookbook"
 
-`Exploring BeagleBone <https://bbb.io/ebb>`__ and `Embedded Linux Primer <https://bbb.io/elp>`__
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+`Exploring BeaglebBone <https://bbb.io/ebb>`_ and `Embedded Linux Primer <https://bbb.io/elp>`_
 
-To take things to the next level of detail, consider "Exploring
-BeagleBone" which can be considered the missing software manual and
-utilize "Embedded Linux Primer" as a companion textbook to provide a
-strong base on embedded Linux suitable for working with any hardware
-that will run Linux.
+To take things to the next level of detail, consider "Exploring BeagleBone" which can be considered 
+the missing software manual and utilize "Embedded Linux Primer" as a companion textbook to provide 
+a strong base on embedded Linux suitable for working with any hardware that will run Linux.
 
 .. |image0| image:: images/download-latestimage.png
    :width: 75.0%
-- 
GitLab