Im/update resource docs 19

.github/workflows/lint.yml

@@ -38,7 +38,7 @@ jobs:
       - uses: carlosperate/download-file-action@v1.1.2
         id: download-mdl-config
         with:
-          file-url: 'https://raw.githubusercontent.com/chef/chef-web-docs/main/.markdownlint.yaml'
+          file-url: 'https://raw.githubusercontent.com/chef/chef-client-docs/main/.markdownlint.yaml'
           file-name: 'markdownlint.yaml'
       - uses: DavidAnson/markdownlint-cli2-action@v5
         with:
@@ -57,7 +57,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: errata-ai/vale-action@reviewdog
         with:
-          files: '["archetypes", "content", "layouts"]'
-          vale_flags: "--config=tools/vale/.vale-github-action.ini"
+          files: '["content", "layouts"]'
+          vale_flags: "--config=.vale.ini --minAlertLevel=error"
           filter_mode: diff_context
           fail_on_error: true

.vale.ini

@@ -16,3 +16,6 @@ BasedOnStyles = chef, Microsoft, vale, write-good
 
 # Ignore SVG markup
 TokenIgnores = (\*\*\{\w*\}\*\*), (Master License and Services Agreement)
+
+# Modify rule alert levels
+write-good.ThereIs = warning

config/_default/menu.toml

@@ -60,35 +60,195 @@ title = "Install"
 identifier = "install"
 
   [[install]]
-  title = "Migration tool"
-  identifier = "install/migration_tool"
+  title = "Installer"
+  identifier = "install/installer"
   parent = "install"
+  weight = 20
 
   [[install]]
-  title = "Native installer"
-  identifier = "install/installer"
+  title = "Migration Tool"
+  identifier = "install/migration_tool"
   parent = "install"
+  weight = 30
 
 [[licensing]]
 title = "Licensing"
 identifier = "licensing"
 
-[[agentless]]
-title = "Agentless"
-identifier = "agentless"
-
-[[workstation]]
-title = "Chef Workstation"
-identifier = "workstation"
-
-  [[workstation]]
-  title = "Knife"
-  identifier = "workstation/knife"
-  parent = "workstation"
-  weight = 100
-
-  [[workstation]]
-  title = "Test Kitchen Enterprise"
-  identifier = "workstation/tke"
-  parent = "workstation"
-  weight = 200
+[[features]]
+title = "Features"
+identifier = "features"
+
+  [[features]]
+  title = "Agentless Mode"
+  identifier = "features/agentless"
+  parent = "features"
+
+    [[features]]
+    title = "Resources"
+    identifier = "features/agentless/resources"
+    parent = "features/agentless"
+    weight = 40
+
+  [[features]]
+  title = "Chef Solo"
+  identifier = "features/chef_solo"
+  parent = "features"
+
+  [[features]]
+  title = "Ohai"
+  identifier = "features/ohai"
+  parent = "features"
+
+[[integrations]]
+title = "Integrations"
+identifier = "integrations"
+
+  [[integrations]]
+  title = "Azure"
+  identifier = "integrations/azure"
+  parent = "integrations"
+
+  [[integrations]]
+  title = "Windows"
+  identifier = "integrations/windows"
+  parent = "integrations"
+
+[[policy]]
+title = "Policy"
+identifier = "policy"
+
+[[security]]
+title = "Security"
+identifier = "security"
+
+[[cookbooks]]
+title = "Cookbooks"
+identifier = "cookbooks"
+
+  [[cookbooks]]
+  title = "Attributes"
+  identifier = "cookbooks/attributes"
+  parent = "cookbooks"
+  weight = 30
+
+  [[cookbooks]]
+  title = "Recipes"
+  identifier = "cookbooks/recipes"
+  parent = "cookbooks"
+  weight = 70
+
+[[infra_language]]
+title = "Infra language"
+identifier = "infra_language"
+
+[[resources]]
+title = "Resources"
+identifier = "resources"
+
+  [[resources]]
+  title = "Bundled resources"
+  parent = "resources"
+  identifier = "resources/bundled"
+
+  [[resources]]
+  title = "Custom resources"
+  parent = "resources"
+  identifier = "resources/custom"
+
+[[extension_apis]]
+title = "Extension APIs"
+identifier = "extension_apis"
+
+  [[extension_apis]]
+  title = "Compliance DSL"
+  identifier = "extension_apis/inspec/dsl_inspec/ Compliance DSL"
+  parent = "extension_apis"
+  url = "https://docs.chef.io/inspec/latest/profiles/controls/"
+  weight = 20
+
+  [[extension_apis]]
+  title = "Handlers"
+  identifier = "extension_apis/handlers"
+  parent = "extension_apis"
+  weight = 20
+
+    [[extension_apis]]
+    title = "Custom handlers"
+    identifier = "extension_apis/handlers/handlers.md#custom-handlers Custom Handlers"
+    parent = "extension_apis/handlers"
+    url = "/features/handlers/#custom-handlers"
+    weight = 10
+
+    [[extension_apis]]
+    title = "Community handlers"
+    identifier = "extension_apis/handlers/plugin_community.md#handlers Community Handlers"
+    parent = "extension_apis/handlers"
+    url = "/extension_apis/community_plugins/#handlers"
+    weight = 30
+
+  [[extension_apis]]
+  title = "Ohai plugins"
+  identifier = "extension_apis/ohai_plugins"
+  parent = "extension_apis"
+  weight = 40
+
+[[reference]]
+title = "Reference"
+identifier = "reference"
+
+    [[reference]]
+    title = "chef-solo (executable)"
+    identifier = "reference/ctl_chef_solo.md chef-solo (executable)"
+    parent = "reference"
+    url = "/features/chef_solo/ctl_chef_solo/"
+    weight = 20
+
+    [[reference]]
+    title = "Handler DSL"
+    identifier = "reference/dsl_handler.md Handler Commands"
+    parent = "reference"
+    url = "/extension_apis/dsl_handler/"
+    weight = 40
+
+    [[reference]]
+    title = "ohai (executable)"
+    identifier = "reference/ctl_ohai.md ohai (executable)"
+    parent = "reference"
+    url = "/features/ohai/ctl_ohai/"
+    weight = 50
+
+    [[reference]]
+    title = "supermarket-ctl"
+    identifier = "supermarket/reference/ctl_supermarket.md supermarket-ctl"
+    parent = "reference"
+    url = "https://docs.chef.io/supermarket/ctl_supermarket/"
+    weight = 60
+
+    [[reference]]
+    title = "client.rb"
+    identifier = "reference/config_rb_client.md client.rb"
+    parent = "reference"
+    url = "/install/config_rb_client/"
+    weight = 70
+
+    [[reference]]
+    title = "metadata.rb"
+    identifier = "reference/config_rb_metadata.md metadata.rb"
+    parent = "reference"
+    url = "/cookbooks/config_rb_metadata/"
+    weight = 80
+
+    [[reference]]
+    title = "Policyfile.rb"
+    identifier = "reference/config_rb_policyfile.md Policyfile.rb"
+    parent = "reference"
+    url = "/policy/config_rb_policyfile/"
+    weight = 90
+
+    [[reference]]
+    title = "solo.rb"
+    identifier = "reference/config_rb_solo.md solo.rb"
+    parent = "reference"
+    url = "/install/config_rb_solo/"
+    weight = 100

config/_default/params.toml

@@ -7,7 +7,22 @@
 #             Menus are defined in the /config/_default/menu.toml file
 #######
 
-menuOrder = ["landing_page", "install", "licensing", "agentless", "workstation", "resources", "chef_gem_server", "cookbooks", "reference", "release_notes"]
+menuOrder = [
+  "overview",
+  "install",
+  "licensing",
+  "quickstart",
+  "features",
+  "policy",
+  "integrations",
+  "security",
+  "cookbooks",
+  "infra_language",
+  "resources",
+  "extension_apis",
+  "troubleshooting",
+  "reference"
+]
 
 #######
 # robots = The default robots config applied to each page in the robots meta tag.
@@ -26,6 +41,10 @@ robots = ''
 #######
 breadcrumbs = true
 
+[[breadcrumb_base]]
+breadcrumb = "Documentation"
+url = "https://docs.chef.io"
+
 #######
 #
 # Settings for the link and image render hooks.

config/branch-deploy/params.toml

@@ -1,5 +1 @@
-breadcrumbs = true
 
-[[breadcrumb_base]]
-breadcrumb = "Docs"
-url = "https://docs.chef.io"

config/vocabularies/Chef/accept.txt

@@ -0,0 +1,2 @@
+Chef Backend
+[B|b]ackend