Updates samples for migration, removes stale guidelines

[jeana-redhat]

Version(s):
main

Issue:
N/A, from https://docs.google.com/document/d/1bjWS6qWyiuiYTYUAU6Hs5RG-Y6GGcAs06JrVbhEI2mg/edit?disco=AAABnaCa_ic&tab=t.vqt3znw847jf

Link to docs preview:

• Assembly file metadata
• Module file metadata
• Assembly/module titles and section headings
• Assembly subsections (Level 1 headings)
• Writing assemblies
• Automatically generated content (term tweak)
• Using conscious language imho we can probably drop info about 3.11 and pre-4.9 docs at this point.
• Collapsible content docs.redhat doesn't support collapsible blocks, we should not be using these.

DPM review:

• DPM has approved this change.

Additional information:
Noticed a few stale guidelines while i was looking for metadata examples.

[jeana-redhat]

@kalexand-rh, PTAL 🙇

From our discussion in the new merge guidelines doc. Lmk if any other review is needed. If you approve, I can go delete the lines I commented out.

[ocpdocs-previewbot]

🤖 Mon Aug 18 16:34:51 - Prow CI generated the docs preview:

https://96408--ocpdocs-pr.netlify.app/

[kalexand-rh]

@bergerhoffer, is there anything else you want to get into this round of updates?

[bergerhoffer]

Sorry for the delay, this LGTM to me. Though I'd say maybe just remove some of the pieces that you've commented out, just to keep it cleaner.

But otherwise, we can always make additional updates in the future as needed

[openshift-ci]

@jeana-redhat: all tests passed!

Full PR test history. Your PR dashboard.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.