diff --git a/README.md b/README.md
index 1a3a710..f44b313 100644
--- a/README.md
+++ b/README.md
@@ -22,12 +22,12 @@
 
 ## Linking to Markdown (.md) sources
 
-Markdown (.md) files are shown approximately as they will appear on the generated website.
-This is convenient for reviewing changes, but means that linking to the original source requires a bit more work compared with other files.
-If you want to create a Permalink or raise an issue that relates to a particular Markdown source line, proceed as follows:
+Markdown (.md) files appear in the preview pane of the editor approximately as they will appear in the generated website.
+This is convenient for reviewing changes, but means that linking to the source requires a bit more work compared with other files.
+If you want to create a permalink or raise an issue that relates to a particular Markdown source line, proceed as follows:
 - link to the rendered file as normal, for example: [https://github.com/apache/www-site/blob/main/README.md](https://github.com/apache/www-site/blob/main/README.md)
 - append ?plain=1 to the URL, for example: [https://github.com/apache/www-site/blob/main/README.md?plain=1](https://github.com/apache/www-site/blob/main/README.md?plain=1)
-- the file will then be displayed with line numbers, as for other types of files. Click on a line number to generate a Permalink or create an issue with a link to the line
+- the file displays with line numbers, as for other types of files. Click a line number to generate a permalink or create an issue with a link to the line
 
 ## Documentation