1 files changed, 16 insertions, 0 deletions

diff --git a/cs-dotnet/src/gatsstring.cs b/cs-dotnet/src/gatsstring.cs
index 3fa3b7e..0935b05 100644
--- a/cs-dotnet/src/gatsstring.cs
+++ b/cs-dotnet/src/gatsstring.cs
@@ -9,6 +9,22 @@ using System.IO;
 
 namespace Com.Xagasoft.Gats
 {
+    /// <summary>
+    /// Encapsulates a single byte array.
+    /// </summary>
+    /// <remarks>
+    /// A GATS string, unlike a C# string primitive, is simply an array of
+    /// bytes.  This is actually more flexible in many ways, as it allows a
+    /// GatsString to contain any binary data.  However, to encode textual data
+    /// there is no hard and fast standard.  If a string primitive is passed
+    /// into a GatsString it will be encoded into UTF-8.  If you would rather
+    /// use a different encoding then encode your data first, and then pass it
+    /// in as a byte array.
+    ///
+    /// The ToString implementation provided by GatsString also assumes that
+    /// the contained data is UTF-8 encoded.  This may cause some minor issues
+    /// when attempting to debug strings that contain binary.
+    /// </remarks>
     public class GatsString : GatsObject
     {
         public byte[] Value { get; set; }