Adding initial page for developer guidelines concept

Author: stevejgordon

development-guidelines.md

@@ -0,0 +1,35 @@
+---
+layout: default
+---
+
+# Development Guidelines
+
+## Conventions and Patterns
+
+### Mediatr Components - Naming Conventions
+
+The project has adopted a CQRS pattern using the Mediatr library. We have discussed ([read discussion](https://github.com/HTBox/allReady/issues/1262)) the naming for these components and agreed that we will *not* suffix them with "Async".
+
+**Commands:**
+
+A command message should end with "Command" and descibe the action that is intended. e.g.
+
+- EditCampaignCommand
+- DeleteTaskCommand
+
+The handlers should match the command message name with the suffix of "Handler". e.g.
+
+- EditCampaignCommandHandler
+- DeleteTaskCommandHandler
+
+**Queries:**
+
+A query message should end with "Query" and describe the data it returns. e.g.
+
+- EventSummaryQuery
+- TaskDetailQuery
+
+The handlers should match the query message name with the suffix of "Handler". e.g.
+
+- EventSummaryQueryHandler
+- TaskDetailQueryHandler

index.html

@@ -27,6 +27,7 @@ <h2><a href="/finding-a-task.html">Finding a Task</a></h2>
 <h2><a href="/getting-the-code.html">Getting the Code</a></h2>
 <h2><a href="/building-the-project.html">Building the Project</a></h2>
 <h2><a href="/doing-the-work.html">Doing the Work</a></h2>
+<h2><a href="/development-guidelines.html">Development Guidelines (Conventions and Patterns)</a></h2>
 <h2><a href="/submitting-a-pull-request.html">Submitting a Pull Request</a></h2>
 <h2><a href="/responding-to-reviews.html">Responding to Reviews</a></h2>
 <h1>FAQ</h1>