Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

March 14, 2022

Host: Mark Titchener (TSC) - Foundry

Secretary: 

Attendees: 

  • Doug Walker (TSC Chief Architect) - Autodesk
  • Carol Payne (TSC Chair) - Netflix

Apologies:

  • Michael Dolan (TSC) - Epic Games
  • Evan Wilson - Blender Foundation

Technical writing resources proposal

  • Carol: What’s the intention with moving to Confluence. Will the guide remain here or be moved into official OCIO documentation?
  • Mark: We started with the Google doc as it was easier to collaborate on initial ideas. As sections were refined we felt Confluence was a better place to store them longer term. We talked about the possibility of moving into the official documentation eventually.
  • Doug: Didn’t have a clear short term goal as such but using Confluence is easier than creating pull requests.
  • Carol: TAC has been discussing projects need for documentation. It’s a common theme that was recently brought up in the open source forum.
  • Carol: Some representatives from The Linux Foundation attending the open source forum had experience with documentation needs on previous LF projects.
    • General advice was it’s better to contract based on work completed rather than a full time person floating around.
    • This approach also helps projects prioritise their documentation needs.
  • Carol: Whatever the approach, we need to have something written to submit to the TAC for them to review e.g. what do we need and why?
  • Mark: So we’d have two separate documents, one high-level proposal for the TAC and then one more detailed brief for a technical author?
  • Carol: Yeah. Could be one doc if that’s easier and we can pull out the relevant points for the TAC.
  • Mark: Two is fine.
  • Carol: Can just be bullet points to start, we can fill in details as we go.
  • Doug: I like the idea of hiring someone on pay as you go terms. My concern with having a full time technical author is we might not be able to keep up with the amount of work/input they would need from us.
  • Carol: There’s also Google Season of Docs as an option but I don’t know about timings on this yet.
  • Carol: There is a TAC meeting next Wednesday (03/23). Would be great to have a written proposal in place for that if possible.
  • Doug: I should also be able to join that TAC meeting.
  • TODO: Mark to start and share a proposal document for the TAC.


  • No labels