diff --git a/examples/msbr/README.md b/examples/msbr/README.md
index a8b492924..e63ebf0f0 100644
--- a/examples/msbr/README.md
+++ b/examples/msbr/README.md
@@ -1,27 +1,27 @@
 ## MSBR Model
 
-Based on the design paper by Robertson, 1971
+This model is based on the following technical report:
 
-Figure 3.27, pg 46
-Figure 3.4, pg 17
-Figure 3.5, pg 18
-Figure 3.3, pg 16
+Robertson, R. C. (1971). Conceptual Design Study of a Single-Fluid Molten-Salt Breeder Reactor. (ORNL--4541). ORNL.
 
-Model features:
-- Simplified Zone IA (graphite element is idential Zone IIA in the model, does not match original paper spec)
-- Simplified Zone IIA (graphite element does not match the original spec)
+For a complete discussion of the model, please see Chapter 4 in:
+
+Yardas, O. (2023). Implementation and validation of OpenMC in SaltProc [MS Thesis, University of Illinois at Urbana-Champaign].
+
+
+## Key features
+- Zone IB 
+- Zone IIA
 - Simplified Zone IIB (graphite slabs are constructed from cylindrical sectors, and so do not have a consistent width; the last gap in the ccw direction in each octant is smaller than the other gaps, which all have the same dimension)
 - Control rod elements (A Guess, as no spec was provided)
 - Radial reflectors.
-- Simplified axial reflectors (flat and cover more than what the MSBR does)
+- Simplified axial reflectors (flat as opposed to dished in the reference specification)
 
-Missing from model:
-- Zone IB
-- Top part of core (filled with salt?)
+## Missing from model
+- Zone IA
+- Support structure above the main core
 - Radial reflector axial ribs
 - Radial reflector retaining rings
-- Upper salt plenum
 - Zone IIB Graphite Dowel pins and Hastelloy N eliptical pins
 - Salt inlets and outlest
-- Top and bottom dished heads
 - Zone I eliptical graphite sealing pins
diff --git a/scripts/README.md b/scripts/README.md
index 261f82051..7ccb47a6f 100644
--- a/scripts/README.md
+++ b/scripts/README.md
@@ -3,7 +3,7 @@ This directory contains various scripts to help you set-up and analyze results
 of your SaltProc simulations.
 
 ### `xsdata`
-The scripts in this directory downloads and processes cross sections data for
+The scripts in this directory download and processe cross section data for
 use in Serpent and OpenMC
 
 #### `process_jeff312.bash`