Minor docs improvements

Author: craigfowler

ZptSharp.Documentation/articles/WhatIsZptSharp.md

@@ -1,9 +1,10 @@
 # What is ZptSharp?
 
 ZptSharp is an open source [library for .NET] for writing HTML or XML documents based upon page templates.
-It is useable as a library, and packages are available for use:
+It may be used in your own applications as a library.
+Packages are also available to use ZptSharp:
 
-* As an ASP.NET/ASP.NET Core MVC **View Engine**
+* As a **View Engine** for AS<span>P.N</span>ET MVC5 or AS<span>P.N</span>ET Core MVC
 * As a standalone command-line application
 
 ZptSharp is based upon the *Zope Page Templates* specification & syntax.
@@ -16,7 +17,7 @@ ZptSharp is a pure .NET implementation of just the page templates syntax from Zo
 
 ## What is the syntax?
 
-ZPT is *an attribute language* designed specifically for use with HTML and/or XML documents. All of the ZPT directives are placed in **attributes**.
+ZPT is *an attribute language* designed specifically for use with HTML and/or XML documents. All of the ZPT directives are written using **attributes**.
 
 ZPT syntax:
 
@@ -30,17 +31,17 @@ ZPT syntax:
 
 ZPT's syntax is organised into three logical 'modules' of functionality.
 The first of these is an extensible expression syntax for accessing the model, which has the goal of being easy to read & understand without programming knowledge.
-The default syntax looks a lot like a URL path, such as `here/Product/Name`.
+Most expressions will look a lot like a URL path, such as `here/Product/Name`.
 This expression syntax is named **TALES**.
 
 The second is a mechanism (named **METAL**) for reusing markup across document templates and authoring logical parts of a document as separate source files.
 Designers define *macros* of markup for re-use, which may optionally contain *slots* (placeholders).
 At the point of macro usage, markup/content may be supplied to fill the available slots.
 
-The third function of ZPT handles the actual data-binding and manipulation of the document using the model; this a syntax named **TAL**.
-Some aspects of that functionality include (but are not limited to):
+The third function of ZPT handles the actual data-binding and manipulation of the document using the model; this is a syntax named **TAL**.
+Some aspects of that functionality include the following, although this is not a comprehensive list of its capabilities.
 
 * Writing model content to the document
 * Conditionally removing parts of the document
 * Repeating parts of the document for items in a collection
-* Adding/removing/updating attributes & values
+* Adding/removing/updating attributes & values

ZptSharp.Documentation/articles/index.md

@@ -2,7 +2,9 @@
 
 ## Get started
 
-Those who are new to ZptSharp are recommended to follow one of four short **quick start** guides. These guides each take the developer through a 'hello world' example, giving them a working sample app using ZptSharp. You may also wish to read [a conceptual summary] of what ZptSharp is.
+Those who are new to ZptSharp are recommended to follow one of four short **quick start** guides.
+These guides each take the developer through a 'hello world' example, giving them a working sample app using ZptSharp.
+It is also recommended to read [the short conceptual summary of ZptSharp], which illustrates its fundamental principles.
 
 * [Quick start for ASP.NET Core MVC]
 * [Quick start for ASP.NET MVC 5]
@@ -11,7 +13,7 @@ Those who are new to ZptSharp are recommended to follow one of four short **quic
 
 An ideal follow-up to using a quick start guide is to follow [the ZPT tutorial]. This expands upon what was learned during quick-start teaches the full range of ZptSharp functionality.
 
-[a conceptual summary]: WhatIsZptSharp.md
+[the short conceptual summary of ZptSharp]: WhatIsZptSharp.md
 [Quick start for ASP.NET MVC 5]: QuickStart/Mvc5.md
 [Quick start for ASP.NET Core MVC]: QuickStart/MvcCore.md
 [Quick start for the command line renderer]: QuickStart/CliApp.md

ZptSharp.Documentation/index.md

@@ -2,7 +2,7 @@
 
 # Intuitive HTML & XML document templates for .NET
 
-ZptSharp is a document template language & renderer for .NET Framework, .NET Core & .NET 5+.
+ZptSharp is a document template language & renderer for .NET.
 It may be used as a **View Engine** for AS<span>P.N</span>ET MVC5 or AS<span>P.N</span>ET Core MVC.
 It also comes with a command-line rendering tool and may be consumed by your own applications as an API.
 
@@ -25,8 +25,8 @@ It also comes with a command-line rendering tool and may be consumed by your own
 
 ## Get started
 
-Here are some recommended first steps to get learning about ZptSharp and the ZPT syntax.
-You may also visit [the documentation home page] for more links & info.
+Here are some recommended first steps to learn about ZptSharp and the ZPT syntax.
+[The documentation home page] contains more links & reference.
 
 * [What is ZptSharp?]
 * Quick start
@@ -42,8 +42,8 @@ You may also visit [the documentation home page] for more links & info.
 [Command line renderer]: articles/QuickStart/CliApp.md
 [Consume the API]: articles/QuickStart/ConsumingTheApi.md
 [ZPT tutorial]: articles/ZptTutorial/index.md
-[the documentation home page]: articles/index.md
+[The documentation home page]: articles/index.md
 
 </section>
 
-</div>
+</div>