add caveat to BGI example

README.md

@@ -71,7 +71,7 @@ At the beginning of each phase, an outline summarizes:
    * [Configuring and Learning to Use openaps Tools](docs/Log-clean-analyze-with-openaps-tools/using.md)
 * [Phase 2: Build a Manual System](docs/Build-manual-system/considerations.md)
    * [Using oref0 Tools](docs/Build-manual-system/Using-oref0-tools.md)
-   * [Understanding oref0-determine-basal recommendations] (docs/Build-manual-system/Understand-determine-basal.md)
+   * [Understanding oref0-determine-basal recommendations](docs/Build-manual-system/Understand-determine-basal.md)
    * [Creating a Loop and Retry Logic](docs/Build-manual-system/loop-and-retry-logic.md)
 * [Phase 3: Automate Your System](docs/Automate-system/considerations.md)
    * [Creating a Schedule](docs/Automate-system/create-schedule.md)

docs/Build-manual-system/Using-oref0-tools.md

@@ -1,4 +1,4 @@
-#Using oref0 Tools
+# Using oref0 Tools
 
 ## Add the oref0 Virtual Devices
 In Phase 1, you added two physical medical devices to openaps—your pump and your cgm. This was done using the command `$ openaps device add` and then specifying the device name, type, and parameters. OpenAPS tools to gather system profile parameters such as pump settings, calculate the current insulin on board (IOB), and determine if the pump temp basal should be updated or not, are contained in the OpenAPS reference system oref0. Since there is no physical oref0 device, you are essentially adding it to the openaps environment as a virtual device or plugin.
@@ -293,3 +293,4 @@ openaps upload-recent-treatments
 ````
 
 I've noticed it can take a couple of minutes after a successful load of data in NS for the data to show up in the interface so be patient!
+![Basal Profile](../Images/nightscout.png)

reference-design.md

@@ -74,6 +74,7 @@ The algorithm above is sufficient for a simple and safe OpenAPS implementation,
 
 To calculate this deviation, OpenAPS first calculates a term we call “BG Impact” or BGI. BGI is simply the expected effect of the net IOB, calculated by multiplying the current insulin activity times the ISF (see example below). the current insulin activity (first derivative of IOB) * insulin sensitivity. When expressed in units of mg/dL/5m, this represents the degree to which BG “should” be rising or falling, and can be directly compared to the delta between the current and last CGM reading, or an average delta over the last 15m or so. To calculate the deviation, OpenAPS does exactly this comparison, between the 15m average delta in CGM readings and the predicted BGI. 
 
+**The following example uses straight linear math for the purposes of simplicity in explanation.  In reality, the AP algorithm assumes that insulin effectiveness starts off flat, over time builds in efficacy, and eventually tapers off in its usefulness. ** 
 Example: take the scenario of correcting a BG of 200 (where ISF is 1u per 100 mg/dL, DIA is 4 hours, and target BG is 100).
 1. 1u insulin is given to bring BG to 100
 2. There are 48 5-minute segments in 4 hours