diff --git a/README.md b/README.md
index 577d4563b..98c7b0588 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
   <h1>
     <img src="./docs/assets/banner.png" alt="D2" />
   </h1>
-  <p>A modern language that turns text into diagrams.</p>
+  <p>A modern diagram scripting language that turns text to diagrams.</p>
 
 [Language docs](https://d2lang.com) | [Cheat sheet](./docs/assets/cheat_sheet.pdf)
 
diff --git a/docs/INSTALL.md b/docs/INSTALL.md
index a4e28e2eb..71d3fcd0a 100644
--- a/docs/INSTALL.md
+++ b/docs/INSTALL.md
@@ -1,6 +1,6 @@
 # install
 
-This file documents all the ways by which you can install D2.
+You may install D2 through any of the following methods.
 
 <!-- toc -->