[Starlingx-discuss] [docs] [meeting] Docs team notes 2020-04-29
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@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.
participants (1)
-
Camp, MaryX