diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4c74ac0..a0abce9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -20,7 +20,7 @@
 
 ### Changed
 
-- Variables are now referenced by their names, instead of tuples `(var_name, index)`. This change was required to improve the compatibility with other modeling languages, which do not follow this convention. The functions `get_variable_category` and `get_variable_features` now have the following signature:
+- Variables are now referenced by their names, instead of tuples `(var_name, index)`. This change was required to improve the compatibility with modeling languages other than Pyomo, which do not follow this convention. The functions `get_variable_category` and `get_variable_features` now have the following signature:
   ````python
    def get_variable_features(self, var_name: str) -> List[float]:
       pass
@@ -28,7 +28,7 @@
    def get_variable_category(self, var_name: str) -> Optional[Hashable]:
       pass  
    ````
-- Features are now represented as a list of floating point numbers, as indicated in the snipped above. This change was required for performance reasons. Returning numpy arrays is no longer supported.
+- Features are now represented as a list of floating point numbers, as indicated in the snippet above. This change was required for performance reasons. Returning numpy arrays is no longer supported, and raises an error.
 
 - Internal solvers must now be specified as objects, instead of strings. For example,
   ```python
@@ -45,8 +45,8 @@
 
 ### Removed
 
-- Temporarily remove the experimental `BranchPriorityComponent`. This component will be re-added in the Julia version of the package.
-- Removed `solver.add` methods, previously used to add components to an existing solver. Use `LearningSolver(components=[...])` instead.
+- Temporarily removed the experimental `BranchPriorityComponent`. This component will be re-added in the Julia version of the package.
+- Removed `solver.add` method, previously used to add components to an existing solver. Use the constructor `LearningSolver(components=[...])` instead.
 
 ## [0.1.0] - 2020-11-23