[SHACK-358] update docs and navigation for chef.sh

www/site/config.toml

@@ -5,6 +5,8 @@ title = "chef.sh (Chef Workstation)"
 theme = "chef"
 staticDir = ["./static", "../chef-sh"]
 
+sectionPagesMenu = "main"
+
 # To develop against a local copy of the chef hugo theme, uncomment this line
 # and set the value to the parent directory of where you have checked out the
 # chef-hugo-theme repository

www/site/content/docs/_index.md

@@ -1,7 +1,3 @@
 +++
 title = "Sample Docs Page"
-menu = "docs"
 +++
-
-This is not synced into chef-www, only the `chef-workstation` folder is. This file exists simply to make the main docs page not...empty. The content on this page will NOT be synced to `chef/chef-www`
-

www/site/content/docs/chef-workstation/getting-started.md

@@ -35,6 +35,7 @@ inspec version: 2.1.72
 
 The `chef-run` utility allows you to execute ad-hoc configuration updates on the systems you manage without needing to first set up a Chef server. With chef-run, you connect to servers over SSH or WinRM, and can apply single resources, recipes, or entire cookbooks directly from your local workstation.
 
+
 ### Example: Installing NTP Server
 
 Chef Workstation combines the power of InSpec and chef-run to give you the ability to easily detect and correct issues on any target instance. A common task that an environment maintainer performs is ensuring that the Network Time Protocol (NTP) is installed, so clocks are kept in sync between servers. InSpec allows us to simply query whether the package is installed via its package resource:
@@ -82,3 +83,9 @@ Runs the `my_cookbook::my_recipe` cookbook against servers myhost1 through myhos
 ```bash
 chef-run myhost[1:20] my_cookbook::my_recipe
 ```
+
+#### Further Reading
+
+* [Chef Run CLI Reference](https://chef.sh/docs/reference/chef-run/)
+* [Introducing Chef Workstation](https://blog.chef.io/2018/05/23/introducing-chef-workstation/)
+* [Chef Workstation - How We Made that Demo](https://blog.chef.io/2018/06/25/chef-workstation-how-we-made-that-demo/)

www/site/content/docs/reference/_index.md

@@ -0,0 +1,5 @@
++++
+title = "Reference"
+id = "reference"
+menu = "docs"
++++

www/site/content/docs/reference/berks.md

@@ -0,0 +1,12 @@
++++
+title = "berks"
+linkTitle = "berks"
+[menu]
+  [menu.docs]
+    parent = "Reference"
+    weight = "100"
++++
+
+We are in the process of migrating this documentation to its new home here on [chef.sh](https://chef.sh).
+
+Until then, current `berks` documentation can be found on [docs.chef.io](https://docs.chef.io/berkshelf.html).

www/site/content/docs/chef-workstation/cli-reference.md → www/site/content/docs/reference/chef-run.md

@@ -1,12 +1,12 @@
 +++
-title = "CLI Reference"
+linkTitle = "chef-run"
+title = "chef-run"
 [menu]
   [menu.docs]
-    parent = "Chef Workstation"
-    weight = "20"
+    parent = "Reference"
+    weight = "400"
 +++
-
-Chef-run is a tool to execute ad-hoc tasks using Chef.
+`chef-run` is a tool to execute ad-hoc tasks on one or more target nodes using Chef.
 
 `chef-run <TARGET[S]> <RESOURCE> <RESOURCE_NAME> [PROPERTIES] [FLAGS]`
 

www/site/content/docs/reference/chef-shell.md

@@ -0,0 +1,12 @@
++++
+title = "chef-shell"
+linkTitle = "chef-shell"
+[menu]
+  [menu.docs]
+    parent = "Reference"
+    weight = "500"
++++
+
+We are in the process of migrating this documentation to its new home here on [chef.sh](https://chef.sh).
+
+Until then, current `chef-shell` documentation can be found on [docs.chef.io](https://docs.chef.io/chef_shell.html).

www/site/content/docs/reference/chef.md

@@ -0,0 +1,12 @@
++++
+title = "chef"
+linkTitle = "chef"
+[menu]
+  [menu.docs]
+    parent = "Reference"
+    weight = "200"
++++
+
+We are in the process of migrating this documentation to its new home here on [chef.sh](https://chef.sh).
+
+Until then, current `chef` command documentation can be found on [docs.chef.io](https://docs.chef.io/about_chefdk.html), under the heading 'chef (executable).

www/site/content/docs/reference/chefspec.md

@@ -0,0 +1,12 @@
++++
+title = "chefspec"
+linkTitle = "chefspec"
+[menu]
+  [menu.docs]
+    parent = "Reference"
+    weight = "300"
++++
+
+We are in the process of migrating this documentation to its new home here on [chef.sh](https://chef.sh).
+
+Until then, current `chefspec` documentation can be found on [docs.chef.io](https://docs.chef.io/chefspec.html).

www/site/content/docs/reference/inspec.md

@@ -0,0 +1,12 @@
++++
+title = "inspec"
+linkTitle = "inspec"
+[menu]
+  [menu.docs]
+    parent = "Reference"
+    weight = "600"
++++
+
+We are in the process of migrating this documentation to its new home here on [chef.sh](https://chef.sh).
+
+Until then, current `inspec` documentation can be found on [inspec.io](https://www.inspec.io/docs/reference/cli/).

www/site/content/docs/reference/kitchen.md

@@ -0,0 +1,12 @@
++++
+title = "kitchen"
+linkTitle = "kitchen"
+[menu]
+  [menu.docs]
+    parent = "Reference"
+    weight = "700"
++++
+
+We are in the process of migrating this documentation to its new home here on [chef.sh](https://chef.sh).
+
+Until then, current `kitchen` documentation can be found on [docs.chef.io](https://docs.chef.io/ctl_kitchen.html).