Open Documentation Hour schedule

This page includes our planning schedule for Open Documentation Hour, and also lists our ideas pool for prospective future sessions. Feel free to suggest subjects you’d like to see covered, and share those you’d like to see prioritised.

:information_source: See the Open Documentation Hour index for the list of previous office hours with direct links to their published recordings.

Schedule

Date Presenter(s) Demo / discussion
13/12/24 David Ekete Interactive RST and working with CODA
20/12/24 Everyone Festive special quiz

Future ideas

The structure of the office hours is usually a demo, presentation or discussion followed by a question and answer session.

  • Diátaxis related subjects
    • Interview of Daniele, including QA from the writers and community
    • Understanding Diátaxis
    • Documentation workshop; work on a real document live
  • How-to vs. a tutorial
  • Documenting a new project
  • Testing the product, first steps, stages. Inviting contributions
  • Start contributing to an open source project
    • Understanding how the project works and what they need
  • Documentation and design
  • API documentation approaches. Swagger, manual, etc.
  • Documentation as code
  • Pros and cons. Approaches. Docs inside code, externally. How developers may interact with documentation.
  • Discussion: AI, a force for good in documentation?
    • Should we use it? How could we use it? Do we currently use it?
  • Getting feedback
    • Various approaches; analytics, comments, issue requests, pop-ups
    • Conclusions to draw from feedback
    • How to give feedback effectively
    • Reducing support cases
    • Cost benefit of technical authors and why this may be dangerous
  • Demo our editing environments and workflows
  • Tips for getting hired as a technical writer or author
  • How to encourage engineers to write their own documentation
  • CMS / Publishing frameworks
  • Fight! RST vs. XML vs. Markdown
  • On-boarding at Canonical; the challenges of joining a company
  • Some of our favourite documentation (Arch, etc.)
  • Technical author or technical writer
  • Overview of how we edit and publish documentation (Discourse, Sphinx)
  • GitHub Actions for documentation
  • Writing is designing; content design principles and writing
  • Recommended books / reading to help with technical writing
  • Diagrams: standards, software, syntax, tools, and general approaches
  • How to write a resume for a technical author or technical writer position
  • A roundup of note taking applications
  • Writers’ Anonymous: we live edit and try to improve a document submitted to us anonymously
6 Likes