Add basic usage guide with panels, charger (#6)

* Add basic usage guide with panels, charger

* Reorder getting started

docs/conf.py

@@ -23,14 +23,15 @@
 # Add any Sphinx extension module names here, as strings. They can be extensions coming with Sphinx
 # (named 'sphinx.ext.*') or your custom ones.
 extensions = [
-    'sphinx.ext.githubpages',
+    'sphinx_collapse',
+    'sphinx_copybutton',
+    'sphinx_tabs.tabs',
     'sphinx.ext.extlinks',
+    'sphinx.ext.githubpages',
     'sphinx.ext.graphviz',
     'sphinx.ext.mathjax',
     'sphinxcontrib.youtube',
-    'sphinx_copybutton',
-    'sphinx_tabs.tabs',
-    'sphinx_collapse',
+    "sphinx.ext.autosectionlabel",
 ]
 
 # True to prefix each section label with the name of the document it is in, followed by a colon.
@@ -39,6 +40,17 @@
 # documents.
 autosectionlabel_prefix_document = True
 
+# If set, autosectionlabel chooses the sections for labeling by its depth. For example, when set 1
+# to autosectionlabel_maxdepth, labels are generated only for top level sections, and deeper
+# sections are not labeled. It defaults to None (disabled).
+# autosectionlabel_maxdepth = 4
+
+# True to prefix each section label with the name of the document it is in, followed by a colon.
+# For example, index:Introduction for a section called Introduction that appears in document
+# index.rst. Useful for avoiding ambiguity when the same section heading appears in different
+# documents.
+autosectionlabel_prefix_document = True
+
 # If set, autosectionlabel chooses the sections for labeling by its depth. For example, when set 1
 # to autosectionlabel_maxdepth, labels are generated only for top level sections, and deeper
 # sections are not labeled. It defaults to None (disabled).

docs/getting_started.rst

@@ -6,4 +6,5 @@ Getting Started
   :maxdepth: 1
 
   getting_started/hardware_setup.rst
+  getting_started/basic_usage.rst
   getting_started/ros_interface.rst

docs/getting_started/basic_usage.rst

@@ -0,0 +1,48 @@
+===========
+Basic Usage
+===========
+
+Rear Interface Panel
+====================
+
+.. image:: images/panel_rear.jpg
+  :align: center
+  :width: 80%
+
+Interfaces from the left:
+
+* Charger Port
+* Screen
+* Power Button
+* Emergency Stop Button
+
+Top Interface Panel
+===================
+
+.. image:: images/panel_top.jpg
+  :align: center
+  :width: 80%
+
+Interface from the left:
+
+* Unused
+* Power breakout — VBat (~24V), 12V
+* Serial
+* RJ45 (Unused)
+
+Plug-In Charger
+===============
+
+.. image:: images/charger.jpg
+  :align: center
+  :width: 60%
+
+The SLATE base comes with a plug-in battery charger with the following specifications:
+
+* ~110VAC 60Hz On
+* 24VDC - 29.4VDC Out
+* 5A
+* 160W
+
+To charge the SLATE base's battery, plug the charger's barrel jack into the base's Charger Port.
+See the :ref:`getting_started/basic_usage:Rear Interface Panel` for details on the port.