Updated ReadMe.md

Author: RxDave

.gitattributes

@@ -0,0 +1,63 @@
+###############################################################################
+# Set default behavior to automatically normalize line endings.
+###############################################################################
+* text=auto
+
+###############################################################################
+# Set default behavior for command prompt diff.
+#
+# This is need for earlier builds of msysgit that does not have it on by
+# default for csharp files.
+# Note: This is only used by command line
+###############################################################################
+#*.cs     diff=csharp
+
+###############################################################################
+# Set the merge driver for project and solution files
+#
+# Merging from the command prompt will add diff markers to the files if there
+# are conflicts (Merging from VS is not affected by the settings below, in VS
+# the diff markers are never inserted). Diff markers may cause the following 
+# file extensions to fail to load in VS. An alternative would be to treat
+# these files as binary and thus will always conflict and require user
+# intervention with every merge. To do so, just uncomment the entries below
+###############################################################################
+#*.sln       merge=binary
+#*.csproj    merge=binary
+#*.vbproj    merge=binary
+#*.vcxproj   merge=binary
+#*.vcproj    merge=binary
+#*.dbproj    merge=binary
+#*.fsproj    merge=binary
+#*.lsproj    merge=binary
+#*.wixproj   merge=binary
+#*.modelproj merge=binary
+#*.sqlproj   merge=binary
+#*.wwaproj   merge=binary
+
+###############################################################################
+# behavior for image files
+#
+# image files are treated as binary by default.
+###############################################################################
+#*.jpg   binary
+#*.png   binary
+#*.gif   binary
+
+###############################################################################
+# diff behavior for common document formats
+# 
+# Convert binary document formats to text before diffing them. This feature
+# is only available from the command line. Turn it on by uncommenting the 
+# entries below.
+###############################################################################
+#*.doc   diff=astextplain
+#*.DOC   diff=astextplain
+#*.docx  diff=astextplain
+#*.DOCX  diff=astextplain
+#*.dot   diff=astextplain
+#*.DOT   diff=astextplain
+#*.pdf   diff=astextplain
+#*.PDF   diff=astextplain
+#*.rtf   diff=astextplain
+#*.RTF   diff=astextplain

.gitignore

@@ -1,7 +1,5 @@
 ## Ignore Visual Studio temporary files, build results, and
 ## files generated by popular Visual Studio add-ons.
-##
-## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore
 
 # User-specific files
 *.suo
@@ -42,11 +40,10 @@ TestResult.xml
 [Rr]eleasePS/
 dlldata.c
 
-# .NET Core
+# DNX
 project.lock.json
 project.fragment.lock.json
 artifacts/
-**/Properties/launchSettings.json
 
 *_i.c
 *_p.c
@@ -113,10 +110,6 @@ _TeamCity*
 # DotCover is a Code Coverage Tool
 *.dotCover
 
-# Visual Studio code coverage results
-*.coverage
-*.coveragexml
-
 # NCrunch
 _NCrunch_*
 .*crunch*.local.xml
@@ -150,7 +143,7 @@ publish/
 *.azurePubxml
 # TODO: Comment the next line if you want to checkin your web deploy settings
 # but database connection strings (with potential passwords) will be unencrypted
-*.pubxml
+#*.pubxml
 *.publishproj
 
 # Microsoft Azure Web App publish settings. Comment the next line if you want to
@@ -166,7 +159,7 @@ PublishScripts/
 !**/packages/build/
 # Uncomment if necessary however generally it will be regenerated when needed
 #!**/packages/repositories.config
-# NuGet v3's project.json files produces more ignorable files
+# NuGet v3's project.json files produces more ignoreable files
 *.nuget.props
 *.nuget.targets
 
@@ -199,6 +192,7 @@ ClientBin/
 *.jfm
 *.pfx
 *.publishsettings
+node_modules/
 orleans.codegen.cs
 
 # Since there are multiple workflows, uncomment next line to ignore bower_components
@@ -219,7 +213,6 @@ UpgradeLog*.htm
 # SQL Server files
 *.mdf
 *.ldf
-*.ndf
 
 # Business Intelligence projects
 *.rdl.data
@@ -234,20 +227,13 @@ FakesAssemblies/
 
 # Node.js Tools for Visual Studio
 .ntvs_analysis.dat
-node_modules/
-
-# Typescript v1 declaration files
-typings/
 
 # Visual Studio 6 build log
 *.plg
 
 # Visual Studio 6 workspace options file
 *.opt
 
-# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
-*.vbw
-
 # Visual Studio LightSwitch build output
 **/*.HTMLClient/GeneratedArtifacts
 **/*.DesktopClient/GeneratedArtifacts
@@ -272,17 +258,4 @@ paket-files/
 
 # Python Tools for Visual Studio (PTVS)
 __pycache__/
-*.pyc
-
-# Cake - Uncomment if you are using it
-# tools/**
-# !tools/packages.config
-
-# Telerik's JustMock configuration file
-*.jmconfig
-
-# BizTalk build output
-*.btp.cs
-*.btm.cs
-*.odx.cs
-*.xsd.cs
+*.pyc

ReadMe.md

@@ -58,12 +58,22 @@ Using a reactive-first approach, we'll design and implement a client-server chat
 2. In-proc service
 
 #### Client Design
+##### Startup
+1. Start the GUI in the following state: 
+   1. Server URL and Connect button are enabled.
+   2. Chat GUI elements are disabled (including the message list and the Send button).
+2. Load the user's settings.
+3. If the last user name was saved, prepopulate the user name textbox.
+4. If the last service URL was saved, prepopulate the service URL textbox.
+5. If enabled, verify that the user's configured sound is available and it can be played.
+   1. If it cannot, display a warning to the user.
+
 ##### Connecting to the Server
 1. The user can set their "user name" before connecting.
    1. The user name from their last session is displayed by default.
 2. The user must enter a service URL and click a Connect button.
-   1. When the Connect button is pressed:
-      1. Disable it.
+   1. When the Connect button is pressed, and the user name is valid, and the service URL is a valid URI:
+      1. Disable the Connect button.
       1. Display a waiting animation and a Cancel button.
       1. Try connecting to the specified URL.
       1. If the connection cannot be established, or if the service URL is invalid:
@@ -81,20 +91,31 @@ Using a reactive-first approach, we'll design and implement a client-server chat
             1. If the server rejects the password:
                1. Enable the Connect button. (goto #2)
       1. Otherwise, change the Connect button into a Disconnect button and enable it.
+         1. Enable the chat GUI so that messages may be sent and received.
+         2. Save the user name and service URL in the user's settings.
    1. When the Disconnect button is pressed:
       1. Disable it.
       1. Try disconnecting from the specified URL.
          1. If the program fails to disconnect gracefully, then log any errors and continue.
       1. Change the Disconnect button into a Connect button and enable it. (goto #2)
+         1. Disable the chat GUI to prevent messages from being sent or received.
 
 ##### Receiving Messages
-1. TODO
+1. When a message is received:
+   1. If the user's status is not "busy" and the message matches the user's current filter criteria (if any):
+      1. Append the message to the message list.
+         1. Include the date and/or time based on the user's current settings.
+         1. Render the message in the font, size and color received with the message. If none received, use defaults.
+      1. If the option to play a sound is enabled, and the chat window is not currently in focus:
+         1. Play the user's configured sound.
 
 ##### Sending Messages
-1. TODO
+1. When the 'Enter' key is pressed or the 'Send' button is clicked:
+   1. If the message is not entirely whitespace:
+      1. Send the message to the server.
+         1. Include the current font, size and color with the message. Omit them if they are currently the defaults.
 
 #### Server Design
-
 ##### Startup and Configuration
 1. TODO