[Starlingx-discuss] [docs] [meeting] Docs team notes 2020-04-29
Camp, MaryX
maryx.camp at intel.com
Thu Apr 30 14:47:41 UTC 2020
Hello all,
Here are this week's docs team meeting minutes (short form). Details in [2].
Join us if you have interest in StarlingX docs! We meet on Wednesdays 12:30 PST.
[1] Call logistics: https://wiki.openstack.org/wiki/Starlingx/Meetings
[2] Our tracking Etherpad: https://etherpad.openstack.org/p/stx-documentation
thanks,
Mary Camp
==========
2020-04-29
All -- reviews merged since last week: 1 (IPv6)
All -- bug status -- 7 total, 4 WIP
[new ww18] admin endpoints in distributed cloud are changed to https. Where does this go in the docs? Find the place(s) where dist cloud is mentioned -- installation.
[ww17] Debug guide [not started] and Install guide typo [WIP]
[ww16] Kata containers [WIP, location under Kubernetes operations] and Build Avoidance (not started; AR Mary compare bug text to existing guide)
[ww15] Backup & restore procedure info [WIP, review: 721772] Ping Mihnea again, cc Frank Miller. Add to Operations section.
All -- Opens
from Mary: 2 reviews from Ritu Raj haven't passed the Zuul verification for some reason.
Opendev team may be able to help, send email to this address: service-discuss at lists.opendev.org
If no answer, Mary can try to pull down copy of the review and recommit. [Dean T used to be able to help, not on project anymore]
from Bruce: attended marketing call with foundation today, significant need for blog posts, esp new release, new content. Mary is available to help with edits/proofing as needed.
AR for Bruce and Greg to find likely authors for blog posts within the teams.
Search option for docs: MAKE A STORY - our docs page should have a search option. [Mary ask Kris about search, was it looked into?]
Reviews in progress:
Upgrade Kubernetes version (R4 new content) -- Needs final +2.
WIP: Docker proxy setup Priority 1 task
First review merged (1 R3 install guide): https://review.opendev.org/#/c/718298/
Second review merged (7 R3 install guides): https://review.opendev.org/#/c/720252/
AR Mary update patchset to add pointer to new docker proxy page at the next-higher-level of install guides (similar to the IPv4 note, 1 per Rx folder, see https://review.opendev.org/#/c/718302/)
Next review will be for 8 R4 guides.
17Apr Discussion about diagrams - want better alignment between Install diags + Docker Proxy (colors, labels, etc) AR Mary look for PPT source
29Apr Got PPT source for R2 from Kris, figure out how to access it and post updated PPT [[ where link / how to find ]]
Mary follow on AR: Dig deeper into the Install guides -- compare them, look at the ways we reuse text. Are there more ways to streamline?
2 areas for improvement: Troubleshooting solution aka "if you get this message, try this". Also, "how you can tell this is working" check after install.
More information about the Starlingx-discuss
mailing list