[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