24Q1-Q4 planning and activity log for Patrice

[chalin]

Main tasks

1. OpenTelemetry

Planning and tracking

• 2024/01 planning for Patrice open-telemetry/opentelemetry.io#3739
• 2024/02 planning for Patrice open-telemetry/opentelemetry.io#3918
• 2024/Q2-Q4 planning for Patrice open-telemetry/opentelemetry.io#4082

2024 contribution highlights:

• Internationalization:
  • I lead the infrastructure development and localization-team support for i18n. [PR list TBC]
  • Tooling, layouts, and guidelines will be reusable in other projects.
  • As a result of this, and the dedication of our i18n teams, OTel documentation is now available in 6 locales: English, French, Spanish, Brazilian, Japanese, and Chinese!
• Contributor experience improvements: through improved tooling and scripts, as well as updates to Contributing guidelines, in particular: I'm the main author of the Localization contributing guidelines.
• Infrastructure support and improvements, including:
  • Reduced build times especially given the full docs build required for 6 locales. For a full list of PRs, see [PR list TBC].
• Dark-mode support

2. Docsy steering committee and Docsy-related contributions:

• Created basic version of a much needed CNCF docsy-starter.
  • Successfully used as a base for the migration of two CNCF project websites to the use of Hugo + Docsy: theupdateframework.io and in-toto.io. For details see the next section below
• Wrote blog post: Docsy 2024 Review: Adoptions and Enhancements
• Docsy 0.11.0 release, reintroduces Right-To-Left (RTL) language support #1442!
• Docsy 0.10.0:
  • Blog Docsy 0.10.0 release report
  • Release 0.10.0 preparation google/docsy#1812
    • Upgrade to Bootstrap 5.3 google/docsy#1528
    • Support dark mode google/docsy#331
• Blog Docsy 0.9.0 release report
• All my issues and PRs
• My open issues and PRs

3. Website improvements for other CNCF projects - upgrades to using Docsy

• theupdateframework.io: New and improved Docsy-based version of the website #105
• kubernetes/website - contributing to the following Docsy-upgrade issues:
  Align with upstream Docsy · Issue #41171 · kubernetes/website,
  Update theme/docsy step by step to the latest docsy #44002, and
  and Bootstrap and Font Awesome (as part of Docsy) are deprecated · Issue #32905 · kubernetes/website
  • Upgrade to Docsy 0.5.1 via NPM module #48812 - PR author
  • Bump Docsy to 0.3.x #48721 - PR reviewer
• in-toto: Migrate website to use the Docsy theme #76
  • New and improved Docsy-based version of the website in-toto/in-toto.io#86
• Assess Migration to docsy theme jaegertracing/documentation#746

4. LF mentoring 2024/06-08

• My mentorships panel
• in-toto
  • Project entry: Documentation Boost!
  • Add in-toto proposed project mentoring#1224
• TUF
  • Website: theupdateframework.io, repo
  • Project entry: Documentation assessment and improvements
  • Add TUF proposed project mentoring#1225
  • CNCFSD-1516 Do a first look at the TUF project docs... #162
  • My finalization of the project: New and improved Docsy-based version of the website #105
• LF ID account merge request: https://jira.linuxfoundation.org/plugins/servlet/desk/portal/4/SUPPORT-27206

5. Analytics and related tasks

• Public Google Analytics Dashboard open-telemetry/opentelemetry.io#4017
• Help kubewarden.io migrate to GA4
  • https://cncfservicedesk.atlassian.net/browse/CNCFSD-2256
  • Use new CNCF Google Analytics 4 (GA4) site ID kubewarden/kubewarden.io#223
• PipeCD
  • https://cncfservicedesk.atlassian.net/browse/CNCFSD-1859
• [SANDBOX PROJECT ONBOARDING] Logging Operator
  • https://cncfservicedesk.atlassian.net/browse/CNCFSD-2325
  • Google analytics 4 (GA4): configure CNCF ID cncf/toc#244
• Complete gRPC.io domain ownership transfer to LF #151
• Analytics: resolve redundant-hostnames #167

6. Other

• Techdocs
  • Revised TechDoc Analysis Tools #229
• Doc analyses: mentor and reviewer of TUF analysis
• Add training+certs showcase to OTel website #197
  Add an OTel training+certs showcase open-telemetry/opentelemetry.io#3463
• OKRs - none set for 2024

Previous/next

• 23Q1-Q4 planning and activity log for Patrice #166
• 2025Q1-Q4 Planning for Patrice #282