release: Servers101 0.1 ( Fixes #1 )

Adding CHANGELOG, Release Notes, Code of Conduct, Contribution, and Security guides.

Author: StartAutomating

.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [StartAutomating]

CHANGELOG.md

@@ -0,0 +1,12 @@
+## Servers101 0.1:
+
+* Initial Release of Servers101
+* An educational module with small servers in PowerShell (#1)
+* Built with a basic build (#2)
+* Including a single command: `Get-Servers101` (#3)
+* Initial demo servers:
+  * `Server101` (#4)
+  * `DebugServer` (#5)
+  * `EventServer` (#6)
+  * `DualEventServer` (#7)
+  

README.md

@@ -1,2 +1,40 @@
-# Servers101
-Simple Servers in PowerShell
+# Servers 101
+
+Servers are pretty simple.
+
+You listen and then you reply.
+
+That's Servers 101.
+
+## Simple Servers
+
+Frameworks often abstract this away.
+
+This can make the basics of servers harder to learn.
+
+To avoid reliance on the framework flavor of the week, it's good to learn how to build a simple server.
+
+This is a collection of simple servers in PowerShell.
+
+Feel free to [contribute](contributing.md) and add your own.
+
+
+## Server Samples
+
+* [DebugServer.ps1](/Servers/DebugServer.ps1)
+* [DualEventServer.ps1](/Servers/DualEventServer.ps1)
+* [EventServer.ps1](/Servers/EventServer.ps1)
+* [Server101.ps1](/Servers/Server101.ps1)
+* [SwitchServer.ps1](/Servers/SwitchServer.ps1)
+
+## Using this module
+
+This module has only one command, Get-Servers101.
+
+It will return all of the sample servers in the module.
+
+Each server will be self-contained in a single script.  
+
+To start the server, simply run the script.
+
+To learn about how each server works, read thru each script.

README.md.ps1

@@ -0,0 +1,47 @@
+@"
+# Servers 101
+
+Servers are pretty simple.
+
+You listen and then you reply.
+
+That's Servers 101.
+
+## Simple Servers
+
+Frameworks often abstract this away.
+
+This can make the basics of servers harder to learn.
+
+To avoid reliance on the framework flavor of the week, it's good to learn how to build a simple server.
+
+This is a collection of simple servers in PowerShell.
+
+Feel free to [contribute](contributing.md) and add your own.
+
+
+## Server Samples
+
+"@
+
+
+foreach ($serverScript in Get-Servers101) {
+    "* [$($serverScript.Name)]($($serverScript.FullName.Substring("$pwd".Length)))"
+}
+
+
+
+@"
+
+## Using this module
+
+This module has only one command, `Get-Servers101`.
+
+It will return all of the sample servers in the module.
+
+Each server will be self-contained in a single script.  
+
+To start the server, simply run the script.
+
+To learn about how each server works, read thru each script.
+"@

Servers101.psd1

@@ -107,7 +107,21 @@ PrivateData = @{
         # IconUri = ''
 
         # ReleaseNotes of this module
-        # ReleaseNotes = ''
+        ReleaseNotes = @'
+## Servers101 0.1:
+
+* Initial Release of Servers101
+* An educational module with small servers in PowerShell (#1)
+* Built with a basic build (#2)
+* Including a single command: `Get-Servers101` (#3)
+* Initial demo servers:
+  * `Server101` (#4)
+  * `DebugServer` (#5)
+  * `EventServer` (#6)
+  * `DualEventServer` (#7)
+
+
+'@
 
         # Prerelease string of this module
         # Prerelease = ''

code_of_conduct.md

@@ -0,0 +1 @@
+Try to be a good person, and please be polite when providing feedback.

contributing.md

@@ -0,0 +1,9 @@
+Anyone can contribute to this collection of simple servers.
+
+There are only a few ground rules:
+
+There are only a few rules here:
+
+* Servers must be short (~100 lines is ideal)
+* Servers must be named like `*server*.ps1`
+* Servers must simple and mostly harmless

security.md

@@ -0,0 +1,7 @@
+This module is designed to help anyone understand how to build their own server.
+
+Each of the educational servers in this module should run as a low-rights user on a randomized loopback port.
+
+Each of the educational servers are short and easy to inspect for malicious code.
+
+If you find that an educational server is being used in a malicious way or find a security issue with any of the educational servers, please file an issue.