feature(docs): Add getting started documentation for C#.

Fixes aws#696

docs/src/getting-started.rst

@@ -69,6 +69,17 @@ Create an empty project structure for the |cdk| app.
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        Create a new empty, source controlled directory and then create a new
+        console application.
+
+        .. code-block:: sh
+
+            mkdir HelloCdk
+            cd HelloCdk
+            dotnet new console
+
     .. group-tab:: JavaScript
 
         Create an empty source-controlled directory for your project and an
@@ -148,6 +159,14 @@ library includes the basic classes needed to write |cdk| stacks and apps.
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        Install the **Amazon.CDK NuGet** package:
+
+        .. code-block:: sh
+
+            dotnet add package Amazon.CDK
+
     .. group-tab:: JavaScript
 
         Install the **@aws-cdk/cdk** package:
@@ -189,6 +208,26 @@ class. Let's create our first, empty **App**:
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        In **Program.cs**
+
+        .. code-block:: c#
+
+            using Amazon.CDK;
+
+            namespace HelloCdk
+            {
+                class Program
+                {
+                    static void Main(string[] args)
+                    {
+                        var myApp = new App();
+                        myApp.Run();
+                    }
+                }
+            }
+
     .. group-tab:: JavaScript
 
         In **index.js**:
@@ -256,6 +295,14 @@ If needed, compile the code:
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        Compile the code using your IDE or via the dotnet CLI:
+
+        .. code-block:: sh
+
+            dotnet build
+
     .. group-tab:: JavaScript
 
         No need to compile
@@ -323,6 +370,16 @@ your project directory:
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        Define the :code:`--app` option in a **cdk.json** file:
+
+        .. code-block:: json
+
+            {
+              "app": "dotnet run --project HelloCdk.csproj"
+            }
+
     .. group-tab:: JavaScript
 
         Define the :code:`--app` option in **cdk.json** to execute **index.js**
@@ -431,6 +488,44 @@ Define a stack and add it to the app.
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        Create **MyStack.cs**:
+
+        .. code-block:: c#
+
+            using Amazon.CDK;
+
+            namespace HelloCdk
+            {
+                public class MyStack: Stack
+                {
+                    public MyStack(App parent, string name) : base(parent, name, new StackProps())
+                    {
+                    }
+                }
+            }
+
+        In **Program.cs**:
+
+        .. code-block:: c#
+            :emphasize-lines: 10
+
+            using Amazon.CDK;
+
+            namespace HelloCdk
+            {
+                class Program
+                {
+                    static void Main(string[] args)
+                    {
+                        var myApp = new App();
+                        new MyStack(myApp, "hello-cdk");
+                        myApp.Run();
+                    }
+                }
+            }
+
     .. group-tab:: JavaScript
 
         In **index.js**:
@@ -539,6 +634,12 @@ Compile your program:
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        We have configured cdk.json to run "dotnet run", which will
+        restore dependencies, build, and run your application.
+        Therefore, you just need to run the CDK command.
+
     .. group-tab:: JavaScript
 
         Nothing to compile.
@@ -586,6 +687,12 @@ Install the **@aws-cdk/aws-s3** package:
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        .. code-block:: sh
+
+            dotnet add package Amazon.CDK.AWS.S3
+
     .. group-tab:: JavaScript
 
         .. code-block:: sh
@@ -615,6 +722,30 @@ the :py:class:`Bucket <@aws-cdk/aws-s3.Bucket>` class:
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        Create **MyStack.cs**:
+
+        .. code-block:: c#
+            :emphasize-lines: 2,10,11,12,13
+
+            using Amazon.CDK;
+            using Amazon.CDK.AWS.S3;
+
+            namespace HelloCdk
+            {
+                public class MyStack : Stack
+                {
+                    public MyStack(App parent, string name) : base(parent, name, new StackProps())
+                    {
+                        new Bucket(this, "MyFirstBucket", new BucketProps
+                        {
+                            Versioned = true
+                        });
+                    }
+                }
+            }
+
     .. group-tab:: JavaScript
 
         In **index.js**:
@@ -698,6 +829,12 @@ Compile your program:
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        We have configured cdk.json to run "dotnet run", which will
+        restore dependencies, build, and run your application.
+        Therefore, you just need to run the CDK command.
+
     .. group-tab:: JavaScript
 
         Nothing to compile.
@@ -777,6 +914,17 @@ Configure the bucket to use KMS managed encryption:
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        .. code-block:: c#
+            :emphasize-lines: 4
+
+            new Bucket(this, "MyFirstBucket", new BucketProps
+            {
+                Versioned = true,
+                Encryption = BucketEncryption.KmsManaged
+            });
+
     .. group-tab:: JavaScript
 
         .. code-block:: js
@@ -811,6 +959,12 @@ Compile the program:
 
 .. tabs::
 
+    .. group-tab:: C#
+
+        We have configured cdk.json to run "dotnet run", which will
+        restore dependencies, build, and run your application.
+        Therefore, you just need to run the CDK command.
+
     .. group-tab:: JavaScript
 
         Nothing to compile.