Date
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
- 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)