misc improvements + start on component state doc

rmorshea · rmorshea · commit 9426d7d8b711 · 2021-11-17T08:20:01.000-08:00
diff --git a/docs/source/adding-interactivity/components-with-state.rst b/docs/source/adding-interactivity/components-with-state.rst
@@ -1,4 +1,9 @@
 Components With State
 =====================
 
-Under construction :)
+Components often need to change what’s on the screen as a result of an interaction. For
+example, typing into the form should update the input field, clicking “next” on an image
+carousel should change which image is displayed, clicking “buy” should put a product in
+the shopping cart. Components need to “remember” things: the current input value, the
+current image, the shopping cart. In IDOM, this kind of component-specific memory is
+called state.
diff --git a/docs/source/adding-interactivity/dangers-of-mutability.rst b/docs/source/adding-interactivity/dangers-of-mutability.rst
@@ -1,4 +1,6 @@
 The Dangers of Mutability
 =========================
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/escape-hatches/class-components.rst b/docs/source/escape-hatches/class-components.rst
@@ -1,4 +1,6 @@
 Class Components
 ================
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/escape-hatches/index.rst b/docs/source/escape-hatches/index.rst
@@ -10,4 +10,6 @@ Escape Hatches
     writing-your-own-server
     writing-your-own-client
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/escape-hatches/javascript-components.rst b/docs/source/escape-hatches/javascript-components.rst
@@ -31,9 +31,9 @@ Dynamically Loaded Components
 
 .. note::
 
-    This method is not recommended in production systems - see
-    :ref:`Distributing Javascript Components` for more info. Instead, it's best used
-    during exploratory phases of development.
+    This method is not recommended in production systems - see :ref:`Distributing
+    Javascript` for more info. Instead, it's best used during exploratory phases of
+    development.
 
 IDOM makes it easy to draft your code when you're in the early stages of development by
 using a CDN_ to dynamically load Javascript packages on the fly. In this example we'll
diff --git a/docs/source/escape-hatches/writing-your-own-client.rst b/docs/source/escape-hatches/writing-your-own-client.rst
@@ -1,4 +1,6 @@
 Writing Your Own Client
 =======================
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/escape-hatches/writing-your-own-server.rst b/docs/source/escape-hatches/writing-your-own-server.rst
@@ -1,4 +1,6 @@
 Writing Your Own Server
 =======================
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/getting-started/running-idom.rst b/docs/source/getting-started/running-idom.rst
@@ -172,7 +172,7 @@ Here's the list of available configuration types:
 Specific Server Settings
 ------------------------
 
-The ``Config`` :ref:`described above <Configuring Server Settings` is meant to be an
+The ``Config`` :ref:`described above <Configuring Server Settings>` is meant to be an
 implementation agnostic - all ``Config`` objects support a similar set of options.
 However, there are inevitably cases where you need to set up your chosen server using
 implementation specific details. For example, you might want to add an extra route to
diff --git a/docs/source/managing-state/index.rst b/docs/source/managing-state/index.rst
@@ -11,4 +11,6 @@ Managing State
     when-to-reset-state
     writing-tests
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/managing-state/keeping-components-pure.rst b/docs/source/managing-state/keeping-components-pure.rst
@@ -1,4 +1,6 @@
 Keeping Components Pure
 =======================
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/managing-state/logical-flow-of-state.rst b/docs/source/managing-state/logical-flow-of-state.rst
@@ -1,4 +1,6 @@
 Logical Flow of State
 =====================
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/managing-state/shared-component-state.rst b/docs/source/managing-state/shared-component-state.rst
@@ -1,4 +1,6 @@
 Shared Component State
 ======================
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/managing-state/structuring-your-state.rst b/docs/source/managing-state/structuring-your-state.rst
@@ -1,4 +1,6 @@
 Structuring Your State
 ======================
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/managing-state/when-to-reset-state.rst b/docs/source/managing-state/when-to-reset-state.rst
@@ -1,4 +1,6 @@
 When to Reset State
 ===================
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/managing-state/writing-tests.rst b/docs/source/managing-state/writing-tests.rst
@@ -1,4 +1,6 @@
 Writing Tests
 =============
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/reference-material/javascript-api.rst b/docs/source/reference-material/javascript-api.rst
@@ -1,4 +1,6 @@
 Javascript API
 ==============
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/understanding-idom/representing-html.rst b/docs/source/understanding-idom/representing-html.rst
@@ -1,5 +1,9 @@
-How IDOM Represents HTML
-========================
+Representing HTML
+=================
+
+.. note::
+
+    Under construction 👷
 
 We've already discussed how to contruct HTML with IDOM in a :ref:`previous section <HTML
 with IDOM>`, but we skimmed over the question of the data structure we use to represent
@@ -67,5 +71,3 @@ is just a fancy way of saying we have a representation of the document object mo
 `DOM
 <https://en.wikipedia.org/wiki/Document_Object_Model#:~:text=The%20Document%20Object%20Model%20(DOM,document%20with%20a%20logical%20tree.&text=Nodes%20can%20have%20event%20handlers%20attached%20to%20them.>`__
 that is not the actual DOM.
-
-Under construction :)
diff --git a/docs/source/understanding-idom/the-rendering-pipeline.rst b/docs/source/understanding-idom/the-rendering-pipeline.rst
@@ -3,4 +3,6 @@ The Rendering Pipeline
 
 .. talk about layouts and dispatchers
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/understanding-idom/what-are-components.rst b/docs/source/understanding-idom/what-are-components.rst
@@ -1,4 +1,6 @@
 What Are Components?
 ====================
 
-Under construction :)
+.. note::
+
+    Under construction 👷
diff --git a/docs/source/understanding-idom/why-idom-needs-keys.rst b/docs/source/understanding-idom/why-idom-needs-keys.rst
@@ -1,4 +1,6 @@
 Why IDOM Needs Keys
 ===================
 
-Under construction :)
+.. note::
+
+    Under construction 👷
