Attendees

  • Edward Ting
  • Anda Nicolae
  • VMB


Agenda

  • Review action items from 2019-02-21 Docs WG Meeting
  • Meeting setup status
  • Discuss the scope of the docs group
  • Share your fave FOSS docs
  • Current state of the docs
  • VMB: Update on new members?

Minutes

  • Meeting setup status
    • ET has pinged ccain several times to get a weekly meeting set up
    • Will ping again
  • Discuss the scope of the docs group
    • ET: This is a subgroup of the TSC, so…only technical docs? Or marketing docs as well?
    • VMB: We'll probably collaborate w/the TFMWG as needed
    • ET: How about the website?
      • VMB: WordPress site handled by MWG. GitHub Pages? We collaborate w/marketing to review patches
    • ET: How do we approve patches?
      • VMB: Use same process as rest of TF (gerrit), will need a styleguide, etc.
        • Treat docs like code → CI/CD, linter, etc.
    • ET/AN: Put stuff in Google Docs first?
      • VMB: Nope. No access in China. Creates technical debt.
  • Update on new members
    • VMB talking to Fawn & Kieran at Juniper, Abhijeet & Rupam at AT&T. These companies will try to send more tech writer support to us.
  • Share your fave FOSS docs
    • What projects are doing this right?
  • Things we need to figure out
    • Current locations of all documentation: Defer until after the infra move is complete
    • Current CI/CD status of documentation: Defer until after the infra move is complete
    • Current styleguide? If any? VMB will ask Kieran
    • Current format (md/rst)? If any? VMB will ask Kieran
    • Issue tracking preferences & location for documentation
      • Can start to work on this now ← talk about this in the next call
    • Quality criteria for docs? VMB will ask Kieran
    • Patch approval criteria for docs: Defer until the TSC confirms the process for code.
    • How to get more people into the docs group: Edward will bring to the TSC

Action Items

  • VMB: Ask Kieran about styleguide, format of docs, quality criteria for docs
  • Edward: Will ask TSC about getting more docs group members
  • Edward: Will tell TSC that he'll be stepping down as doc group chair
  • VMB: Will add issue tracking topic to agenda for next call (Done: 2019-03-20 Docs WG Meeting)

Backlogged Action Items

  • ???: Get rid of community-docs repo (it's superfluous) ← do this after all of the repos are moved
  • No labels