diff --git a/index.md b/index.md
index c620d8c..38fd368 100644
--- a/index.md
+++ b/index.md
@@ -144,7 +144,7 @@ There are three claim operations: _create_, _update_, and _abandon_.
   <dt>create</dt>
   <dd>Makes a new claim.</dd>
   <dt>update</dt>
-  <dd>Changes the value or amount of an existing claim, without changing the claim ID.</dd>
+  <dd>Changes the value, amount, or channel of an existing claim. Does not change the claim's ID.</dd>
   <dt>abandon</dt>
   <dd>Withdraws a claim, freeing the associated credits to be used for other purposes.</dd>
 </dl>
diff --git a/readme.md b/readme.md
index fe3348f..7975b7f 100644
--- a/readme.md
+++ b/readme.md
@@ -17,7 +17,7 @@ To view the content locally, you must have [Ruby](https://www.ruby-lang.org/en/d
 To edit the spec:
 
 - run `bundle exec jekyll serve --watch`
-- make changes in `v1.md`
+- make changes to the markdown
 - refresh `localhost:4000` in your browser to see the effect of your changes.
 
 Contributions to this project are welcome, encouraged, and compensated. For more details, [click here](https://lbry.io/faq/contributing).
@@ -35,4 +35,4 @@ We take security seriously. Please contact security@lbry.io regarding any securi
 
 ## Contact
 
-The primary contact for this project is [@lyoshenka](https://github.com/lyoshenka) (grin@lbry.io).
\ No newline at end of file
+The primary contact for this project is [@lyoshenka](https://github.com/lyoshenka) (grin@lbry.io).