[Starlingx-discuss] [docs] [meeting] Docs team notes 03-Mar-21

[Camp, MaryX]

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]   Tracking Etherpad: https://etherpad.openstack.org/p/stx-documentation 

thanks,
Mary Camp
==========
03-Mar-21 
All -- reviews merged since last meeting:  0
All -- bug status -- 17 total - team agrees to defer all low priority LP until the upstreaming effort is completed. 

Status/questions/opens

Reminder to Greg that a couple reviews need final approval: 
   SNMPv3 doc changes: https://review.opendev.org/c/starlingx/docs/+/773544
   Security guide update: https://review.opendev.org/c/starlingx/docs/+/771288

Regarding the question from last week, PTP won't be upstreamed yet per Greg, it is not part of release 5.0. 

Closing the gap between August WRCP snapshot and the current upstream content. This will eliminate the double work that WR team is dealing with now. 
   Rafael has submitted first review towards this: https://review.opendev.org/c/starlingx/docs/+/778528
   Ron and Juanita will review first, then add other reviewers when it's ready for approval. 
   Another person will be helping out also. 
   After this, we will sort out the duplicated info (2nd priority). 

API documentation questions
   Engineer is making updates, this is a completely new repository (not starlingx/config like SNMP changes).
   https://review.opendev.org/c/starlingx/ptp-notification-armada-app/+/777850
   Content is more than just APIs but also description and figures. 
   First step is to set up the ptp repository to mimic starlingx/config with api-ref/source folder, py.conf, index.rst, etc.
   
Ron seeing some issues with "mirror" of the STX upstream to be used as the baseline for WRCP docs.  
   Scott joined meeting and made helpful suggestions for this issue. 

Version drop-down update - first review is submitted, mostly under the hood changes. 
   https://review.opendev.org/c/starlingx/docs/+/778556
   Mary will add reviewers.