[Starlingx-discuss] [docs] [meeting] Docs team notes 08-09-2023

[Balaraj, Juanita]

Hello All,



Here are this week's doc team meeting minutes. Details in [2].

Join us if you have interest in StarlingX docs! We meet on Fridays 6:00 a.m. PST.



  [1]   Call logistics: https://wiki.openstack.org/wiki/Starlingx/Meetings<https://urldefense.com/v3/__https:/wiki.openstack.org/wiki/Starlingx/Meetings__;!!AjveYdw8EvQ!NoQkF8y98qm5bzC0aLXc-Ha2PwKv0IoJNr9KxUYiPgSUBLYKlyANyi-m6SBGKv10OKvS5zE$>

  [2]   Tracking Etherpad: https://etherpad.openstack.org/p/stx-documentation<https://urldefense.com/v3/__https:/etherpad.openstack.org/p/stx-documentation__;!!AjveYdw8EvQ!NoQkF8y98qm5bzC0aLXc-Ha2PwKv0IoJNr9KxUYiPgSUBLYKlyANyi-m6SBGKv10sTSK2HE$>



Thanks,

Juanita Balaraj

============
08- September-23

Action Items / Status:

- Stx 9.0 Release Tracking Spreadsheet: Doc Stories are tracked in  https://docs.google.com/spreadsheets/d/1aTjYzUkExodfayt-rjTv466jE-DP8b_YjrTHhXW6G9w/edit?usp=sharing. - To add stories that are planned for Stx 9.0 - AR Juanita - WIP (add / replan as required). Features have been removed from Stx 9.0. See https://etherpad.opendev.org/p/stx-cores for more details.
- Discussion about Merging the Installation Guides ; Virtual env with the Bare metal docs.  https://review.opendev.org/c/starlingx/docs/+/876107  - 3 options: AR Ron to reach out to Bruno- StarlingX discuss group
    - Split the docs and retain them as separate guides at a high level. Resue content from Bare Metal in the Virtual env docs.
    - Get rid of the Virtual Guide and use tabs in the Baremetal guide with Virtual env updates
    - Maintain the virtual guide and pull the shared content in from Baremetal - Bruno / Ron -
- Ron to update the Troubleshooting information in the Sphinx Contributor Guide - AR Ron
- Discussion about upgrading to the latest Sphinx / tox version; https://pypi.org/project/tox/: https://review.opendev.org/c/starlingx/docs/+/890833 - AR Ron
 - Documentation Contributor Guide - StarlingX documentation - https://docs.starlingx.io/contributor/doc_contribute_guide.html - All to update the Contributor guide on an ongoing basis for new Styles / Standards implemented - The team to familiarize themselves with the Styles and Standards Guide. Contributor Guide - AR StarlingX Doc team
Gerrit reviews:
-  Open Reviews pending; https://review.opendev.org/q/starlingx/docs+status:open  - Merged 2 Reviews. To get closure of the open reviews at the earliest.
- Check with Greg and if the Installation doc updates are required on Stx 8.0  https://review.opendev.org/c/starlingx/docs/+/876107 - AR Ron / Juanita
- https://review.opendev.org/c/starlingx/docs/+/890960 - AR Ron to check with Scott about the Antelope repositories
Launchpad Doc Bugs:
- https://bugs.launchpad.net/starlingx/+bugs?field.tag=stx.docs Total 10 outstanding bugs.
Miscellaneous Updates:
- Stx. Virtual PTG Meeting: https://openinfra.dev/ptg/  - Stx Doc team is encouraged to participate in sessions as required.
- Update the Verified H/W page with the automated script updates https://www.windriver.com/studio/operator/self-validated-and-certified-hosts#<https://www.windriver.com/studio/operator/self-validated-and-certified-hosts> - Currently Commented out - Script needs to be updated- Waiting for updates to the script -AR Ron - WIP
- Bruno Muniz showed interest in creating DOC Videos supporting the StarlingX Installation Process. To check with Ildiko / Greg whether this is ok. These Videos can be hosted in a location in StarlingX. The Installation Docs can point to these videos - AR Bruno to get approvals from Ildiko / Greg  for a  future Update
-  Operations Guide Archive - On Hold until further clarifications are discussed with Greg (https://review.opendev.org/c/starlingx/docs/+/822030)
Engineering Status:
StarlingX Eng Stx Status: https://etherpad.opendev.org/p/stx-status
StarlingX Eng Status 2023 https://etherpad.opendev.org/p/stx-cores
StarlingX OS Status: https://etherpad.opendev.org/p/stx-distro-other

____________________________
Starlingx-discuss mailing list
Starlingx-discuss at lists.starlingx.io<mailto:Starlingx-discuss at lists.starlingx.io>
http://lists.starlingx.io/cgi-bin/mailman/listinfo/starlingx-discuss<https://urldefense.com/v3/__http:/lists.starlingx.io/cgi-bin/mailman/listinfo/starlingx-discuss__;!!AjveYdw8EvQ!NoQkF8y98qm5bzC0aLXc-Ha2PwKv0IoJNr9KxUYiPgSUBLYKlyANyi-m6SBGKv10aHImBAc$>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.starlingx.io/pipermail/starlingx-discuss/attachments/20230911/7cb6ce35/attachment.htm>