o3de / o3de.org

The O3DE website
Other
85 stars 159 forks source link

[ISSUE][DOCS] Articles in 'draft' state needing evaluation or removal #1868

Open sptramer opened 2 years ago

sptramer commented 2 years ago

Describe the issue

We have a number of draft: true articles, which are published on staging environments for PRs, but not on the main website (or on the development branch version.) These articles need to either:

  1. Be evaluated to see if they should be published at this time, or remain drafts
  2. Be deleted due to lack of relevancy.

Impacted page(s)

The following pages are in draft:

content\docs\welcome-guide\setup\firewall.md
content\docs\welcome-guide\setup\perforce-plugin.md
content\docs\welcome-guide\setup\updating.md
content\docs\user-guide\visualization\cinematics\create-cinematics-with-simple-motion-animations-in-track-view-editor.md
content\docs\user-guide\visualization\environments\_index.md
content\docs\user-guide\visualization\cameras\_index.md
content\docs\user-guide\project-config\project-source-control.md
content\docs\user-guide\programming\remote-console.md
content\docs\user-guide\appendix\file-formats.md
content\docs\user-guide\cloud\_index.md
content\docs\user-guide\appendix\command-line-tools.md
content\docs\user-guide\interactivity\entities\_index.md
content\docs\user-guide\components\reference\networking\_index.md
content\docs\user-guide\interactivity\navigation-and-pathfinding\_index.md
content\docs\user-guide\interactivity\physics\nvidia-blast\debug.md
content\docs\user-guide\interactivity\physics\nvidia-blast\process-blast-asset.md
content\docs\user-guide\interactivity\physics\nvidia-blast\script-canvas.md
content\docs\user-guide\interactivity\physics\nvidia-blast\materials.md
content\docs\user-guide\interactivity\physics\nvidia-blast\simulate.md
content\docs\user-guide\interactivity\physics\nvidia-blast\static-chunks.md
content\docs\user-guide\interactivity\physics\nvidia-blast\_index.md
content\docs\user-guide\interactivity\physics\nvidia-blast\install-houdini-plugin.md
content\docs\user-guide\interactivity\physics\nvidia-blast\create-blast-asset.md
content\docs\user-guide\components\reference\destruction\blast-family-mesh-data.md
content\docs\user-guide\components\reference\destruction\simulate.md
content\docs\user-guide\components\reference\destruction\_index.md
content\docs\user-guide\components\reference\destruction\blast-family.md
content\docs\user-guide\appendix\available-ebus.md
content\docs\user-guide\editor\bottom-toolbar.md
content\docs\user-guide\gems\reference\environment\vegetation-gem-assets.md
content\docs\user-guide\editor\handling-selection-viewport.md
content\docs\user-guide\editor\layers.md
content\docs\user-guide\editor\level-inspector.md
content\docs\user-guide\editor\perspective-pane.md
content\docs\user-guide\editor\mobile-settings.md
content\docs\user-guide\editor\top-toolbar.md
content\docs\user-guide\editor\status-bar.md
content\docs\user-guide\editor\editor-menus.md
content\docs\user-guide\gems\reference\physics\nvidia\nvidia-blast.md
content\docs\user-guide\gems\reference\debug\automated-launcher-testing.md
content\docs\atom-guide\dev-guide\materials\material-build-pipeline.md
content\docs\atom-guide\dev-guide\materials\material-system-data-flow.md
content\docs\atom-guide\dev-guide\rpi\creating-a-feature-processor.md
content\docs\atom-guide\dev-guide\shaders\runtime-api.md
content\docs\atom-guide\dev-guide\rhi\root-constants.md
content\docs\atom-guide\dev-guide\rhi\shader-resource-groups.md
content\docs\atom-guide\dev-guide\rhi\srgs-and-constant-data.md
content\docs\atom-guide\dev-guide\rhi\work-submission.md
content\docs\user-guide\gems\reference\aws\aws-gamelift\multiplayer-sample.md
content\docs\learning-guide\cookbooks\_index.md

Expected experience

We keep as few pages as possible in draft state - the SIG should work out an official policy around draft content, which may no longer be necessary with the main/development split or website versioning changes.

sptramer commented 2 years ago

Via @micronAMZN - Blast docs were moved to draft (and is still useful!) but the Blast asset processing is not working correctly at this time. Animation is in draft because old docs are under hold, but need extensive rewrites. Editor docs are also in need of update because of the UX changes - needs to be rewritten or even reorganized into other topics.

Should be segmented out by section rather than an uber-ticket, in order to perform these types of individual evaluations.

Importantly, cookbook is here because we haven't written any content (snippet-style cut & paste solutions) for it yet.

@sptramer - Split ticket!