22Q2 planning and work log

[chalin]

Note: some issues listed here are multi-step tracking issues. Open the issue to see steps and progress.

🟢 Actively being worked on:

• Integrate the OTel specification into the website #906
• Omnibus Documentation Consolidation 2k22 #1201
• Ensure non-API docs are hosted on opentelemetry.io #833
• CI: check file formatting, including markdown #1063
• ...

🟡 Top / next to do:

• Create and use a config/section parameter for release versions for each language + collector #1194
• Invalid HTML generated by website #1170
• CI: check external links #1052
• Markdown cleanup: use {{% %}} rather than {{< >}} #1149
• Define and enforce a policy for introducing redirects when site pages are deleted #668
• Complete file setup for recommended use of docsy #744
• Use console code class for console sessions #949
• Post-docsy 2020/10 cleanup #669
• CI: run spelling checker #948
• Information Architecture (IA) 2022 assessment and rework #1268

🔴 Blocked/awaiting:

• Ensure non-API docs are hosted on opentelemetry.io #833
  • Migrate Python docs to this repo #1109
• Status page rework #925 -- @tedsuo et all
• [meta] OpenTracing archiving #1039
• ...

🟠 Other to do:

• Pages with non-trivial but short TOCs don't get displayed #712
• Workshop resources seem obsolete #896
• Contribution guidelines needs rework or should be dropped #897
• Make a copyedit pass over Added documentation for telemetry section #1211

☑️ Done

For a complete list, see closed 22Q2 PRs

Prev/next:

• 22Q1 planning and work log #1035
• 22Q3-Q4 planning and work log #1511

Reorder items above using drag-and-drop.

[chalin]

For the next quarter, see #1511