22Q3-Q4 planning and work log

[chalin]

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

☑️ Done (selected).

For a complete list, see closed 22Q3-Q4 PRs

• [meta] OpenTracing archiving #1039
• Status page rework 22Q3 #1574
• Ensure that all doc pages have a single source repo #730, now that Ruby docs have been migrated
• Integrate the OTel specification into the website #906
  • Will track longer-term subtask separately: [editorial] Ensure every section has a README opentelemetry-specification#2558
• Pages with non-trivial but short TOCs don't get displayed #712
• Set up image for social media posts #1519
• Set up Google Analytics 4 #1515
• Omnibus Documentation Consolidation 2k22 #1201
• Status page rework #925 -- @tedsuo et all
• Google analytics: switch from Netlify injection to Hugo config #1517
• ...

Prev/next:

• 22Q2 planning and work log #1266
• 23Q1 planning for chalin #2163

---

🟢 Actively being worked on:

• ...

🟡 Top / next to do:

• Address GDPR compliance requirements #1636
• Define and enforce a policy for introducing redirects when site pages are deleted #668
• CI: check external links #1052
• Create and use a config/section parameter for release versions for each language + collector #1194
• CI: check file formatting, including markdown #1063
• Add tooling in support of auto-update of code excerpts in docs #1635

🔴 Blocked/awaiting:

• Ensure non-API docs are hosted on opentelemetry.io #833
  • Migrate Python docs to this repo #1109
• ...

🟠 Ongoing:

• Ensure non-API docs are hosted on opentelemetry.io #833
• Invalid HTML generated by website #1170
• Markdown cleanup: use {{% %}} rather than {{< >}} #1149
• 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

🟠 Other to do:

• 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

Reorder items above using drag-and-drop (Drag-and-drop doesn't seem to work anymore.)

[chalin]

As of 2022/08/21, here are the infrastructure tasks (high & medium priority) in order of decreasing priority (from @svrnm via #otel-comms Slack discussion, +1 by @cartermp):

1. GDPR
2. Policies for redirects for deleted pages
3. Check For External Links
4. Section Parameters
5. Markdown Checks
6. Tooling for code excerpts

I'll update the Top/next to do ordered list in the opening comment to reflect this. /cc @austinlparker