Date
29 May 2019
Attendees
VM (Vicky) Brasseur (she/her)
Tatsuya Naganawa
Daniel Pono Takamori
Kieran Milne
Will Stevens
Agenda
Action items from
2019-05-22 Docs Project Meeting
Coding style guide will be incoming from Juniper
Confirm initial list of Committers
What to do about
contrail-docs
?
Consider moving the meeting?
Minutes
omg it's 1AM for Tatsuya-san!
Action Items
Pono: link/ write docs on how to add members to voting groups (for new Gerrit)
2 systems, one manual & one automated
Will do manual for now
Pono will write that up
Where to put this? Wiki or repo?
Put in wiki for now until we get the repo cleaned up, then move to repo later
vicky: while at Juniper got a coding style guide that can be ported into the community
codify it into gerrit/ workflow?
will: linter or more style guide/ best practices
vicky: if no linter, there should be one eventually
Initial list of Docs Committers
From the
mailing list
:
Kieran (for now; will have a replacement soon-ish)
Will
Darien
Pono
Vicky
Folks are +1 on the list
swill: Possible to have only one person review then merge…?
Yeah, but can change whatever we want
Right now disallow someone reviewing their own stuff
Also, non-committers can vote
vmb: Problem for OpenStack: requirement to get reviews to merge means patches can languish
TSC will need to keep an eye on this
What to do about contrail-docs?
swill confirms that the docs build, images show
Release notes have a conf.py file, but getting started guide doesn't, copied it over & that worked fine; easy fix to send
Good starting point
vmb: De-Contrailization? A sticky problem.
Can't just do a dumb find/replace
We should assume that no code renaming will happen
For instance, contrail-controller won't be renamed
…buuuuut, that's referred to as Contrail Controller in the docs. What do we do about that?
Plus we don't know what these things will be called yet in the TF docs (TF? Tungsten? Tungsten Fabric?)
Going to be a ton of manual work regardless
Parcel it out across the group, each person work on pieces
Use a wiki page to track standards for changing things
VMB move the repo to TF GH, then we'll put this on hold for a couple weeks so we can have some time to take care of some other stuff.
Start with the Getting Started Guide (GSG)
swill: Start from top to bottom
vmb: Start from bottom to top
Moving the meeting?
OK with moving it to the other end of the day
VMB will send out a Doodle
Action items
Daniel Pono Takamori
Still working on the adding members to voting groups
VM (Vicky) Brasseur (she/her)
Create a backlogged action item list and add "move stuff from wiki to repo" to it
VM (Vicky) Brasseur (she/her)
Open ticket to create voting group for tf/docs
VM (Vicky) Brasseur (she/her)
Move the contrail-docs repo into TF GitHub namespace (
transfer ownership
)
VM (Vicky) Brasseur (she/her)
Whip up a wiki page for Contrail → TF docs project
Will Stevens
Add the conf.py to the GSG
VM (Vicky) Brasseur (she/her)
Send out a Doodle for moving the meeting (incl current time)