Doc update

Author: tanner-andrulis

notebooks/2_making_models.ipynb

@@ -35,15 +35,15 @@
     "- `leak_scaling_function`: The scaling function to use for leakage power. Use `None` if\n",
     "  no scaling should be done.\n",
     "- `include_subcomponents`: Whether to also scale the subcomponents by the same factors.\n",
-    "  Defaults to `True`; pass `False` to scale only this component.\n",
+    "  Defaults to `True`.\n",
     "\n",
     "Many different scaling functions are defined and available in `hwcomponents.scaling`.\n",
     "\n",
-    "The `area_scale`, `energy_scale`, `latency_scale`, `throughput_scale`, and\n",
-    "`leak_power_scale` attributes are read-only properties that report a component's\n",
-    "accumulated scale factors. To change them outside of `self.scale`, call the matching\n",
-    "`scale_area`, `scale_energy`, `scale_latency`, `scale_throughput`, or `scale_leak_power`\n",
-    "method. Each takes a required `include_subcomponents` argument."
+    "You may see what the result of scaling is by checking the `area_scale`, `energy_scale`,\n",
+    "`latency_scale`, `throughput_scale`, and `leak_power_scale` attributes of a component.\n",
+    "Note that these apply to the component directly, not subcomponents. You may also\n",
+    "manually modify these with the `scale_area`, `scale_energy`, `scale_latency`,\n",
+    "`scale_throughput`, or `scale_leak_power` methods."
    ]
   },
   {
@@ -227,14 +227,7 @@
     "- An adder that adds the increment value to the current address\n",
     "\n",
     "One new functionality is used here. The `subcomponents` argument to the\n",
-    "`ComponentModel` constructor is used to register subcomponents.\n",
-    "\n",
-    "A component's area and leak power add up from its subcomponents, and subcomponent action\n",
-    "costs accumulate into the component's actions. To scale a compound model, the\n",
-    "`scale_area`, `scale_energy`, `scale_latency`, `scale_throughput`, and `scale_leak_power`\n",
-    "methods (and `self.scale`) take an `include_subcomponents` argument: pass `True` to scale\n",
-    "the component together with all of its subcomponents, or `False` to scale only this\n",
-    "component and leave the subcomponents untouched."
+    "`ComponentModel` constructor is used to register subcomponents."
    ]
   },
   {