Merge pull request #20 from richardschneider/1-doc

docs: improve

appveyor.yml

@@ -67,7 +67,7 @@ after_test:
         packages\coveralls.net.0.6.0\tools\csmacnz.coveralls.exe 
         --opencover -i ./coverage.xml --useRelativePaths --serviceName appveyor --jobId %APPVEYOR_BUILD_NUMBER%
 # Build documentation in doc\_site
-    - del src\obj\*.* /s /q
+#    - del src\obj\*.* /s /q
     - docfx doc\docfx.json --logLevel Warning
     - 7z a -tzip docs.zip doc\_site
     - appveyor PushArtifact docs.zip

doc/articles/intro.md

@@ -1,13 +1,19 @@
 # DNS Clients
 
-Various DNS clients that communicate with a DNS server. The source code is on [GitHub](https://github.com/richardschneider/net-udns) and the package is published on [NuGet](https://www.nuget.org/packages/Makaretu.Dns.Unicast).
+This package provides various unicast DNS clients, stub resolvers, that communicate with a DNS server. The source code is on [GitHub](https://github.com/richardschneider/net-udns) and the package is published on [NuGet](https://www.nuget.org/packages/Makaretu.Dns.Unicast).
 
 - [DnsClient](xref:Makaretu.Dns.DnsClient) is used to send a [Message](xref:Makaretu.Dns.Message) 
-  to a standard DNS server and receive a response; uses UPD and then TCP (if needed).
-- [DohClient](xref:Makaretu.Dns.DohClient) is used to send a [Message](xref:Makaretu.Dns.Message) 
-  to a DNS over HTTPS server and receive a response.
-- [DotClient](xref:Makaretu.Dns.DotClient) is used to send a [Message](xref:Makaretu.Dns.Message) 
-  to a DNS over TLS server and receive a response.
+  to a standard DNS server and receive a response; uses UPD and then TCP (if needed). There is no privacy.
+
+- [DohClient](xref:Makaretu.Dns.DohClient), DNS over HTTPS (DoH), is an experimental protocol for performing remote 
+Domain Name System (DNS) resolution via the HTTPS protocol. The goal
+is to increase user privacy and security by preventing eavesdropping and 
+manipulation of DNS data by man-in-the-middle attacks.
+
+- [DotClient](xref:Makaretu.Dns.DotClient), DNS over TLS (DoT), is a security protocol for encrypting and wrapping 
+DNS queries and answers via the Transport Layer Security (TLS) protocol. The goal 
+is to increase user privacy and security by preventing eavesdropping and 
+manipulation of DNS data via man-in-the-middle attacks.
 
 ## Usage
 

doc/toc.yml

@@ -2,3 +2,5 @@
   href: articles/
 - name: Api Documentation
   href: api/
+- name: Github
+  href: https://github.com/richardschneider/net-udns

src/DohClient.cs

@@ -23,7 +23,7 @@ namespace Makaretu.Dns
     ///   manipulation of DNS data by man-in-the-middle attacks.
     ///   <para>
     ///   The <b>DohClient</b> uses the HTTP POST method to hide as much
-    ///   information as is possible.  Also, it tends to generated smaller
+    ///   information as is possible.  Also, it tends to generate smaller
     ///   requests.
     ///   </para>
     /// </remarks>