diff --git a/docs/source/getting_started/index.rst b/docs/source/getting_started/index.rst
index 51628c67f..7a92c212a 100644
--- a/docs/source/getting_started/index.rst
+++ b/docs/source/getting_started/index.rst
@@ -1,7 +1,9 @@
 Getting started with Yosys
 ==========================
 
-.. todo:: brief overview for the getting started index
+This section covers how to get started with Yosys, from installation to a guided
+walkthrough of synthesizing a design for hardware, and finishing with an
+introduction to writing re-usable Yosys scripts.
 
 .. toctree::
    :maxdepth: 3
diff --git a/docs/source/getting_started/scripting_intro.rst b/docs/source/getting_started/scripting_intro.rst
index 6e75a3bcc..e971432c0 100644
--- a/docs/source/getting_started/scripting_intro.rst
+++ b/docs/source/getting_started/scripting_intro.rst
@@ -97,8 +97,8 @@ Detailed documentation of the select framework can be found under
 
 .. _show_intro:
 
-The show command
-~~~~~~~~~~~~~~~~
+Displaying schematics
+^^^^^^^^^^^^^^^^^^^^^
 
 While the :cmd:ref:`select` command is very useful, sometimes nothing beats
 being able to see a design for yourself.  This is where :cmd:ref:`show` comes
@@ -190,5 +190,8 @@ expression instead.
 
 .. _GraphViz color docs: https://graphviz.org/doc/info/colors
 
+For all of the options available to :cmd:ref:`show`, check the command reference
+at :doc:`/cmd/show`.
+
 .. seealso:: :ref:`interactive_show` on the
    :doc:`/using_yosys/more_scripting/interactive_investigation` page.