Process: Updates for moving docs content to web-unified-docs repo. (#27097)

* Updates for moving docs content to web-unified-docs repo.

* Tim's feedback: update contributing/checklists

* add to tag nomad-docs for help

Author: aimeeu

.github/ISSUE_TEMPLATE/config.yml

@@ -3,9 +3,12 @@
 
 blank_issues_enabled: false
 contact_links:
+  - name: Create a documentation issue
+    url: https://github.com/hashicorp/web-unified-docs/issues
+    about: Create a Nomad documentation bug or content request in the    web-unified-docs repository.
   - name: Ask a Question
     url: https://discuss.hashicorp.com/c/nomad
     about: If you have a question, or are looking for advice, please post on our Discuss forum.
-  - name: Nomad Learn Tracks
-    url: https://learn.hashicorp.com/nomad
-    about: Please check out our Learn Guides. These hands on guides deal with many of the tasks common to using Nomad.
+  - name: Nomad Tutorials
+    url: https://developer.hashicorp.com/nomad/tutorials
+    about: Please check out our tutorials. These tutorials provide in-depth   learning on Nomad features.

.github/pull_request_template.md

@@ -21,9 +21,14 @@ merged.
 - [ ] **Testing** Please add tests to cover any new functionality or to demonstrate bug fixes and
   ensure regressions will be caught.
 - [ ] **Documentation** If the change impacts user-facing functionality such as the CLI, API, UI,
-  and job configuration, please update the  Nomad website documentation to reflect this. Refer to
-  the [website README](../website/README.md) for docs guidelines. Please also consider whether the
-  change requires notes within the [upgrade guide](../website/content/docs/upgrade/upgrade-specific.mdx).
+  and job configuration, please update the Nomad product documentation, which is
+  stored in the [`web-unified-docs` repo](https://github.com/hashicorp/web-unified-docs/). Refer to
+  the [`web-unified-docs` contributor
+  guide](https://github.com/hashicorp/web-unified-docs/docs/contribute.md) for
+  docs guidelines. Please also consider whether the
+  change requires notes within the [upgrade
+  guide](https://developer.hashicorp.com/nomad/docs/upgrade/upgrade-specific).
+  If you would like help with the docs, tag the `nomad-docs` team in this PR.
 
 ### Reviewer Checklist
 - [ ] **Backport Labels** Please add the correct backport labels as described by the internal

CODEOWNERS

@@ -5,17 +5,3 @@
 
 # codeowner default
 *                              @hashicorp/github-nomad-core @hashicorp/nomad-eng
-
-
-# engineering and web presence get notified of, and can approve changes to web tooling, but not content.
-
-/website/               @hashicorp/web-devdot @hashicorp/github-nomad-core @hashicorp/nomad-eng
-/website/data/
-/website/public/
-/website/content/
-
-# education and engineering get notified of, and can approve changes to web content.
-
-/website/data/          @hashicorp/nomad-docs @hashicorp/github-nomad-core @hashicorp/nomad-eng
-/website/public/        @hashicorp/nomad-docs @hashicorp/github-nomad-core @hashicorp/nomad-eng
-/website/content/       @hashicorp/nomad-docs @hashicorp/github-nomad-core @hashicorp/nomad-eng

README.md

@@ -13,8 +13,11 @@ Nomad is a simple and flexible workload orchestrator to deploy and manage contai
 
 Nomad is supported on Linux, Windows, and macOS. A commercial version of Nomad, [Nomad Enterprise](https://developer.hashicorp.com/nomad/docs/enterprise), is also available.
 
-* Website: https://developer.hashicorp.com/nomad
-* Tutorials: [HashiCorp Developer](https://developer.hashicorp.com/nomad/tutorials)
+* [Documentation - concepts, user guides, reference](https://developer.hashicorp.com/nomad/docs)
+* [CLI docs](https://developer.hashicorp.com/nomad/commands)
+* [API docs](https://developer.hashicorp.com/nomad/api-docs)
+* [Nomad plugins docs](https://developer.hashicorp.com/nomad/plugins)
+* [Tutorials](https://developer.hashicorp.com/nomad/tutorials)
 * Forum: [Discuss](https://discuss.hashicorp.com/c/nomad)
 
 Nomad provides several key features:
@@ -35,26 +38,23 @@ Quick Start
 ---
 
 #### Testing
-See [Developer: Getting Started](https://developer.hashicorp.com/nomad/tutorials/get-started) for instructions on setting up a local Nomad cluster for non-production use.
+Refer to the [Getting Started tutorials](https://developer.hashicorp.com/nomad/tutorials/get-started) for instructions on setting up a local Nomad cluster for non-production use.
 
 Optionally, find Terraform manifests for bringing up a development Nomad cluster on a public cloud in the [`terraform`](terraform/) directory.
 
 #### Production
-See [Developer: Nomad Reference Architecture](https://developer.hashicorp.com/nomad/tutorials/enterprise/production-reference-architecture-vm-with-consul) for recommended practices and a reference architecture for production deployments.
+Refer to [Production reference architecture](https://developer.hashicorp.com/nomad/docs/deploy/production/reference-architecture) for recommended practices and a reference architecture for production deployments.
 
-Documentation
----
-Full, comprehensive documentation is available on the Nomad website: https://developer.hashicorp.com/nomad/docs
+#### Documentation
 
-Guides are available on [HashiCorp Developer](https://developer.hashicorp.com/nomad/tutorials).
+Nomad product documentation is stored in the [`web-unified-docs` repo](https://github.com/hashicorp/web-unified-docs/).
 
-Roadmap
----
+#### Roadmap
 
 A timeline of major features expected for the next release or two can be found in the [Public Roadmap](https://github.com/orgs/hashicorp/projects/202/views/1).
 
 This roadmap is a best guess at any given point, and both release dates and projects in each release are subject to change. Do not take any of these items as commitments, especially ones later than one major release away.
 
-Contributing
---------------------
+#### Contributing
+
 See the [`contributing`](contributing/) directory for more developer documentation.

contributing/README.md

@@ -5,7 +5,7 @@ This directory contains some documentation about the Nomad codebase,
 aimed at readers who are interested in making code contributions.
 
 If you're looking for information on _using_ Nomad, please instead refer
-to the [Nomad website](https://developer.hashicorp.com/nomad).
+to the [Nomad product documentation](https://developer.hashicorp.com/nomad).
 
 The [good first issue label](https://github.com/hashicorp/nomad/issues?q=is:issue+is:open+label:%22good+first+issue%22)
 is used to identify issues which are suited to first time contributors.

contributing/checklist-command.md

@@ -36,8 +36,16 @@ CLI (command/) -> API Client (api/) -> HTTP API (command/agent) -> RPC (nomad/)
 
 ## Docs
 
-* [ ] Changelog
+* [ ] Changelog entry in your code PR.
+
+Find Nomad product docs in the `web-unified-docs` repo. Refer to the
+[`web-unified-docs` contributor
+guide](https://github.com/hashicorp/web-unified-docs/docs/contribute.md) for
+instructions. If you need help with docs, [create an issue in the web-unified
+docs repo](https://github.com/hashicorp/web-unified-docs/issues). On the Issue
+form, choose "Nomad" as the product so that your issue is assigned to the
+nomad-docs team.
+
 * [ ] API docs https://developer.hashicorp.com/nomad/api
 * [ ] CLI docs https://developer.hashicorp.com/nomad/commands
-* [ ] If adding new docs see [website README](../website/README.md#editing-navigation-sidebars)
-* [ ] Consider if it needs a guide https://developer.hashicorp.com/nomad/guides/index.html
+* [ ] Consider if your change needs a user guide.

contributing/checklist-jobspec.md

@@ -39,12 +39,20 @@ required in the original `jobspec` package.
 
 ## Docs
 
-* [ ] Changelog
+* [ ] Changelog entry in your code PR.
+
+Find Nomad product docs in the `web-unified-docs` repo. Refer to the
+[`web-unified-docs` contributor
+guide](https://github.com/hashicorp/web-unified-docs/docs/contribute.md) for
+instructions. If you need help with docs, [create an issue in the web-unified
+docs repo](https://github.com/hashicorp/web-unified-docs/issues). On the Issue
+form, choose "Nomad" as the product so that your issue is assigned to the
+nomad-docs team.
+
 * [ ] Jobspec entry https://developer.hashicorp.com/nomad/docs/job-specification/index.html
-* [ ] Jobspec sidebar entry https://github.com/hashicorp/nomad/blob/main/website/data/docs-navigation.js
 * [ ] Job JSON API entry https://developer.hashicorp.com/nomad/api/json-jobs.html
 * [ ] Sample Response output in API https://developer.hashicorp.com/nomad/api/jobs.html
-* [ ] Consider if it needs a guide https://developer.hashicorp.com/nomad/guides/index.html
+* [ ] Consider if your change needs a user guide.
 
 ## JSON Encoding
 

contributing/checklist-rpc-endpoint.md

@@ -54,6 +54,15 @@ Prefer adding a new message to changing any existing RPC messages.
 
 ## Docs
 
-* [ ] Changelog
+* [ ] Changelog in your code PR.
+
+Find Nomad product docs in the `web-unified-docs` repo. Refer to the
+[`web-unified-docs` contributor
+guide](https://github.com/hashicorp/web-unified-docs/docs/contribute.md) for
+instructions. If you need help with docs, [create an issue in the web-unified
+docs repo](https://github.com/hashicorp/web-unified-docs/issues). On the Issue
+form, choose "Nomad" as the product so that your issue is assigned to the
+nomad-docs team.
+
 * [ ] [Metrics](https://developer.hashicorp.com/nomad/docs/reference/metrics#server-metrics)
 * [ ] [API docs](https://developer.hashicorp.com/nomad/api-docs) for RPCs with an HTTP endpoint, include ACLs, params, and example response body.