Date
10 Apr 2019
Attendees
VM (Vicky) Brasseur (she/her)
, Juniper
Will Stevens
, CloudOps
Kieran Milne
, Juniper
Anda Nicolae
, Lenovo
Agenda
Review action items from
2019-04-03 Docs WG Meeting notes
Review notes from
2019-04-03 Docs WG Meeting notes
PTL question update
Issue tracking
see
this email
lf-docs
see
this email
Next steps…?
Minutes
Action items
All done
Notes from last week
List of docs from all over the place (thank you,
Kieran Milne
)
KM's suggestions for moving forward
Community-created/-maintained
Leverage Contrail docs
Use fully Juniper docs
VM: Start with Contrail docs, move to TF repo
WS: May not need to import history of Contrail docs
KM: Tooling for the Contrail docs conversion is at least a year old
Previous conversion
KM: Also will need to rebrand the docs to TF and re-link the topic pages
For instance,
these links are broken
KM: Over time, Juniper content will be more than just TF
VM: TF docs will be source of truth, won't need another dump of docs; Juniper will start contributing to TF docs instead
KM: May need more resources to make stuff happen on Juniper side
VM: May be able to get an assist from Progmatic if needed?
PTL update
No word from the TSC yet
Issue tracking
How did we used to do that? (no one has prior experience w/docs bugs)
Should get pono's input
WS: On another project, users don't notice the Jira and instead use GitHub since that's what they see
KM w/a summary of how the Juniper team is using Jira for new features & doc bugs
Jira for new features (story isn't complete until docs are complete)
GNATS for doc bugs
lf-docs
Other projects use Read The Docs, should we?
Folks are +1 to assuming we'll use Read The Docs
pono may have more info on this
Next steps…?
VMB & KM have conversations w/in Juniper to start the conversion process
WS will have a look at
https://tungstenfabric.github.io/website/
& draft how to improve it
Action items
VM (Vicky) Brasseur (she/her)
Start a "what even is a PTL?" thread on tsc@ if it doesn't get covered in the TSC call tomorrow
VM (Vicky) Brasseur (she/her)
Invite pono to next week's meeting to talk about how to organise the issue tracking and intro to Read The Docs
VM (Vicky) Brasseur (she/her)
Add docs requirement for closing blueprint to the backlogged action items
Will Stevens
will have a look at
https://tungstenfabric.github.io/website/
& draft how to improve it (won't be done by next week)