Update README.md.

gk-brown · gk-brown · commit f4cceefcc669 · 2019-09-22T07:41:43.000-04:00
diff --git a/README.md b/README.md
@@ -6,9 +6,6 @@ HTTP-RPC is an open-source framework for implementing RESTful and REST-like web
 
 This guide introduces the HTTP-RPC framework and provides an overview of its key features.
 
-# Feedback
-Feedback is welcome and encouraged. Please feel free to [contact me](mailto:gk_brown@icloud.com?subject=HTTP-RPC) with any questions, comments, or suggestions. Also, if you like using HTTP-RPC, please consider [starring](https://github.com/gk-brown/HTTP-RPC/stargazers) it!
-
 # Contents
 * [Getting HTTP-RPC](#getting-http-rpc)
 * [HTTP-RPC Classes](#http-rpc-classes)
@@ -560,7 +557,7 @@ would produce the following output:
 Enums are encoded using their ordinal values. Instances of `java.util.Date` are encoded as a long value representing epoch time. All other values are encoded via `toString()`. Unsupported (i.e. non-map) sequence elements are ignored.
 
 ## TemplateEncoder
-The `TemplateEncoder` class is responsible for merging a [template document](template-reference.md) with a data dictionary. It provides the following constructors:
+The `TemplateEncoder` class transforms an object hierarchy into an output format using a [template document](template-reference.md). It provides the following constructors:
 
 ```java
 public TemplateEncoder(URL url) { ... }
@@ -585,10 +582,10 @@ public Map<String, Object> getContext() { ... }
 Templates are applied using one of the following methods:
 
 ```java
-public void writeValue(Object value, OutputStream outputStream) { ... }
-public void writeValue(Object value, OutputStream outputStream, Locale locale) { ... }
-public void writeValue(Object value, Writer writer) { ... }
-public void writeValue(Object value, Writer writer, Locale locale) { ... }
+public void write(Object value, OutputStream outputStream) { ... }
+public void write(Object value, OutputStream outputStream, Locale locale) { ... }
+public void write(Object value, Writer writer) { ... }
+public void write(Object value, Writer writer, Locale locale) { ... }
 ```
 
 The first argument represents the value to write (i.e. the data dictionary), and the second the output destination. The optional third argument represents the locale for which the template will be applied. If unspecified, the default locale is used.
@@ -606,7 +603,7 @@ TemplateEncoder encoder = new TemplateEncoder(getClass().getResource("map.txt"),
 
 String result;
 try (StringWriter writer = new StringWriter()) {
-    encoder.writeValue(map, writer);
+    encoder.write(map, writer);
     
     result = writer.toString();
 }
@@ -633,7 +630,7 @@ Modifiers are created by implementing the `TemplateEncoder.Modifier` interface,
 public Object apply(Object value, String argument, Locale locale);
 ```
  
-The first argument to this method represents the value to be modified, and the second is the optional argument value following the `=` character in the modifier string. If an argument is not specified, this value will be `null`. The third argument contains the encoder's locale.
+The first argument to this method represents the value to be modified, and the second is the optional argument value following the "=" character in the modifier string. If an argument is not specified, this value will be `null`. The third argument contains the encoder's locale.
 
 For example, the following code creates a modifier that converts values to uppercase:
 
diff --git a/template-reference.md b/template-reference.md
@@ -23,9 +23,9 @@ Variable names represent keys into the data dictionary. When the template is pro
 
 Nested values can be referred to using path notation; e.g. "name.first". Missing (i.e. `null`) values are replaced with the empty string in the generated output. 
 
-Variable names beginning with "@" represent resource references, and are replaced with the corresponding values from the provided resource bundle when the template is processed. 
+Variable names beginning with "@" represent resource references, and are replaced with the corresponding values from the resource bundle when the template is processed. 
 
-Variable names beginning with "$" represent context references, and are replaced with the corresponding values from the provided context dictionary when the template is processed. 
+Variable names beginning with "$" represent context references, and are replaced with the corresponding values from the template context when the template is processed. 
 
 ### Modifiers
 Modifiers are used to transform a variable's representation before it is written to the output stream; for example, to apply an escape sequence.
@@ -39,7 +39,7 @@ Modifiers are specified as shown below. They are invoked in order from left to r
 All templates support the following set of standard modifiers:
 
 * `format` - applies a [format string](https://docs.oracle.com/javase/8/docs/api/java/util/Formatter.html#syntax)
-* `^html`, `^xml` - applies markup encoding to a value
+* `^html` - applies HTML encoding to a value
 * `^url` - applies URL encoding to a value
 
 For example, the following marker applies a format string to a value and then URL-encodes the result:
@@ -122,7 +122,7 @@ For example, a data dictionary that contains information about homes for sale mi
 }
 ```
 
-A template to present these results in an HTML table is shown below. The section markers are enclosed in HTML comments so they will be ignored by syntax-aware text editors, and will simply resolve to empty comment blocks when the template is processed:
+A template to transform these results into HTML is shown below. The section markers are enclosed in HTML comments so they will be ignored by syntax-aware text editors, and will simply resolve to empty comment blocks when the template is processed:
 
 ```html
 <table>
@@ -137,7 +137,9 @@ A template to present these results in an HTML table is shown below. The section
 </table>
 ```
 
-A dot character (".") can be used to represent the current element in a sequence. This can be useful when rendering scalar values. A dot can also be used to represent the sequence itself; for example, when a sequence is the root object:
+A dot character (".") can be used to represent the current element in a sequence. This can be useful when rendering scalar values. 
+
+A dot can also be used to represent the sequence itself; for example, when a sequence is the root object:
 
 ```
 {{#.}}
@@ -174,7 +176,9 @@ Hello, World!
 Includes inherit their context from the parent document, so they can refer to elements in the parent's data dictionary. This allows includes to be parameterized. Self-referencing includes can also be used to facilitate recursion.
 
 ## Comments
-Comment markers provide informational text about a template's content. They are not included in the final output. For example, when the following template is processed, only the content between the `<p>` tags will be included:
+Comment markers provide informational text about a template's content. They are not included in the final output. 
+
+For example, when the following template is processed, only the content between the `<p>` tags will be included:
 
 ```
 {{! Some placeholder text }}
