intro: new stubs

intro/beagle101/arm.rst

+.. _intro-arm:
+
+Introduction to Arm
+###################
+
+.. todo:: Place-holder for Arm tutorial

intro/beagle101/assembly.rst

+.. _intro-assembly:
+
+Introduction to Assembly Programming
+####################################
+
+Assembly programming is a programming style that is the most direct to the binary machine
+instructions a computer follows.
+
+.. todo:: Write assembly guide

intro/beagle101/basic-wiring.rst

+.. _intro-basic-wiring:
+
+Introduction to Wiring Electronics
+##################################
+
+.. todo:: Place-holder for electronics wiring tutorial

intro/beagle101/blinkLED.rst

@@ -3,8 +3,8 @@
 
 .. _blinkLED:
 
-Blink LED
-#########
+Blink an LED
+############
 
 The "Hello World!" of the embedded world is to blink an LED. 
 Here we'll show you how to do just that in three simple steps. 

intro/beagle101/buildroot.rst

+.. _intro-buildroot:
+
+Introduction to Buildroot
+#########################
+
+.. todo:: Place-holder for Buildroot tutorial

intro/beagle101/learning-c.rst → intro/beagle101/c.rst

-.. _beagle101-learning-c:
+.. _intro-c:
 
-Learning C
-##########
+Introduction to C
+#################
 
 .. todo:: Place-holder for tutorial on the C programming language

intro/beagle101/debian.rst

+.. _intro-debian:
+
+Introduction to Debian
+######################
+
+.. todo:: Place-holder for Debian tutorial

intro/beagle101/device-tree.rst

+.. _intro-device-tree:
+
+Introduction to Device Tree
+###########################
+
+.. todo:: Place-holder for Device Tree tutorial

intro/beagle101/embedded-serial.rst

+.. _intro-embedded-serial:
+
+Introduction to Embedded Serial Interfaces
+##########################################
+
+.. todo:: Place-holder for embedded serial interfaces tutorial

intro/beagle101/fpga.rst

+.. _intro-fpga:
+
+Introduction to Field Programmable Gate Arrays (FPGAs)
+######################################################
+
+.. todo:: Place-holder for FPGA tutorial

intro/beagle101/index.rst

@@ -3,20 +3,53 @@
 An Introduction to Beagles
 ##########################
 
+The most common path to using a Beagle is to use a body of open source software. The
+primary open source targets supported by the BeagleBoard.org community are:
+
+* :ref:`intro-beagle-linux` and
+* :ref:`intro-beagle-zephyr`.
+
+Many other paths are possible, but, if you don't already have a path, these are the
+ones to typically go down.
+
+If you are new to embedded systems in general, you might consider starting at:
+
+* :ref:`intro-embedded-systems`
+
 .. toctree::
    :maxdepth: 1
    :hidden:
 
    blinkLED
-   learning-c
-   linux
+   c
+   assembly
+   verilog
+   basic-wiring
+   embedded-serial
    qwiic-stemma-grove-addons
+   motors
+   zephyr
+   linux
+   device-tree
+   fpga
+   verification
+   arm
+   riscv
+   openbeagle-ci
+   buildroot
+   debian
+   wireless-communications
 
-Linux-enabled boards
-********************
+.. _intro-beagle-linux:
+
+Getting started with Linux
+**************************
 
 Most Beagles have on-board flash preconfigured to run Linux. These resources will get you started quickly.
 
+Linux Basics
+============
+
 * Get started at :ref:`blinkLED`.
 * Learn to reset a board back to factory defaults and dive a bit deeper into the IDE at :ref:`beagleboard-getting-started`.
 * Learn a bit about Linux at :ref:`intro-linux`.
@@ -24,21 +57,79 @@ Most Beagles have on-board flash preconfigured to run Linux. These resources wil
 * Learn about using 3rd party I2C add-on boards at :ref:`qwiic_stemma_grove_addons`.
 * Learn about using mikroBUS add-on boards at :ref:`beagleplay-mikrobus`.
 * Learn about using Cape add-on boards at :ref:`capes`.
+* Learn about device tree at :ref:`intro-device-tree`.
 * Read :ref:`bone-cook-book-home`.
 * Read :ref:`pru-cookbook-home`.
 * Find more books at https://www.beagleboard.org/books.
 
-Zephyr-enabled boards
-*********************
+More on Linux
+=============
+
+* :ref:`intro-buildroot`
+* :ref:`intro-debian`
+
+.. _intro-beagle-zephyr:
+
+Getting started with Zephyr
+***************************
 
 Our Zephyr-enabled boards ship with a build of Micropython and, in the future, will also
 ship with a BeagleConnect Greybus node service for quick, transparent access from any BeagleConnect
 Greybus host enabled system.
 
+Zephyr Basics
+=============
+
+* Learn a bit about Zephyr at :ref:`intro-zephyr`
 * See :ref:`beagleconnect-freedom-using-micropython` to get started quickly.
 * See :ref:`beagleconnect-freedom-using-zephyr` to learn to setup the Zephyr SDK.
 * See :ref:`beagleconnect-overview` to learn about BeagleConnect Greybus.
 
+.. _intro-embedded-systems:
+
+Getting started with embedded systems
+*************************************
+
+An embedded system is a computer designed not to look like a computer. That is, it
+is designed to work like an applicance, doing what you need when you need it, rather
+than sitting around trying to get your attention and begging to be told what to do.
+
+An embedded system is built around a computer, but adds additional sensors and
+actuators to do a task, like make toast or get you to work on time along using the
+freeway. We don't typically call these things computers. Instead, we call them "toasters"
+or "cars". At the heart of these machines is often a programmable computer, though it
+might not be programmable by *you*.
+
+At BeagleBoard.org, we seek to enable you to make embedded systems of your own, rather
+than relying on other people to make them for you. You could call it DIY, or do-it-yourself,
+but the reality is more DIT, or do-it-together. The skills and tools to build an embedded
+system are very complicated and the fundamental manufacturing tools are very expensive, so we
+need to work together to build even the simplest of embedded systems.
+
+Of course, there is nothing wrong with building a dumb toaster, it might even be preferred.
+However, if you are building a smart toaster, you might want it to obey you, rather than
+someone 50,000 km away.
+
+Embedded Systems Basics
+=======================
+
+Here are some basic skills to building an embedded system:
+
+* :ref:`intro-c`
+* :ref:`intro-assembly`
+* :ref:`intro-verilog`
+
+More on Embedded Systems
+========================
+
+Here are some more advanced topics around building an embedded system:
+
+* :ref:`intro-fpga`
+* :ref:`intro-verification`
+* :ref:`intro-arm`
+* :ref:`intro-riscv`
+* :ref:`intro-wireless-communications`
+
 .. todo::
 
    Make sure we have everything critical from https://beagleboard.github.io/bone101/Support/bone101/

intro/beagle101/linux.rst

 .. _intro-linux:
 
-An Introduction to Linux
-########################
+Introduction to Linux
+#####################
 
 This article seeks to give you some quick exploration of Linux. For a deeper training,
 scroll down to :ref:`embedded-linux-training`.

intro/beagle101/motors.rst

+.. _intro-motors:
+
+Introduction to Motors
+######################
+
+.. todo:: Place-holder for Motors tutorial

intro/beagle101/openbeagle-ci.rst

+.. _intro-openbeagle-ci:
+
+Introduction to OpenBeagle Continuous Integration (CI)
+######################################################
+
+.. todo:: Place-holder for OpenBeagle CI tutorial

intro/beagle101/riscv.rst

+.. _intro-riscv:
+
+Introduction to RISC-V
+######################
+
+.. todo:: Place-holder for RISC-V tutorial

intro/beagle101/verification.rst

+.. _intro-verification:
+
+Introduction to Verification
+############################
+
+.. todo:: Place-holder for verification tutorial

intro/beagle101/verilog.rst

+.. _intro-verilog:
+
+Introduction to Verilog
+#######################
+
+.. todo:: Place-holder for tutorial on the Verilog programming language

intro/beagle101/wireless-communications.rst

+.. _intro-wireless-communications:
+
+Introduction to Wireless Communications
+#######################################
+
+.. todo:: Place-holder for Wireless Communications tutorial

intro/beagle101/zepyr.rst

+.. _intro-zephyr:
+
+Introduction to Zephyr RTOS
+###########################
+
+.. todo:: Place-holder for Zephyr tutorial