7a - nim project create - for issue #862

docs/project-creating-your-own.md

@@ -0,0 +1,66 @@
+---
+id: nim-creating-project
+title: Creating your project
+sidebar_label: Creating your project
+---
+
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+### Creating your project template with the Nimbella CLI
+
+With the Nimbella CLI, you can create a project template that you can use to instantly start building your project.
+
+To create a project template, run this command in your command prompt:
+
+```
+nim project create folder_name
+```
+
+After running this command in your command prompt, you should see a message saying your project folder is available.
+
+<img alt="Docusaurus with Keytar" src={useBaseUrl('static/img/nim-project-create-ex.png')} />
+
+### Creating a YAML file for your project
+
+**NOTE**: What makes Nimbella standout is that you don't need a YAML file for most simple projects. But if you want to customize specific things you are deploying, you can build a `.yml` file for it.
+
+To generate a `.yml` file when you create a project. Run the command:
+
+```
+nim project create folder_name --config
+```
+
+The `--config` flag tells the CLI to generate a `.yml` template you can use for your project. You should see this template inside of your project folder:
+
+```
+targetNamespace: ''
+cleanNamespace: false
+bucket: {}
+parameters: {}
+environment: {}
+packages:
+  - name: default
+    shared: false
+    clean: false
+    environment: {}
+    parameters: {}
+    annotations: {}
+    actions:
+      - name: hello
+        clean: false
+        binary: false
+        main: ''
+        runtime: 'nodejs:default'
+        web: true
+        webSecure: false
+        parameters: {}
+        environment: {}
+        annotations: {}
+        limits: {}
+```
+
+### Basics of the project structure.
+
+After creating the project folder, you'll see that it contains two folders. A `web` folder to add directories and files with static web content and a `packages` folder to create serverless functions.
+
+[Click here to learn more about the project structure you just created.](https://github.com/nimbella/docs/blob/master/docs/projects.md)

sidebars.js

@@ -32,7 +32,7 @@ module.exports = {
 			'workbench-playground-introduction',
 			'workbench-playground-exports',
 		],
-		'Getting Started': ['getting-started', 'building'],
+		'Getting Started': ['getting-started', 'building', 'nim-creating-project'],
 		'Developing and Deploying Serverless APIs': [
 			'sample-project-walkthrough',
 			'basic-kv-commands',