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

[Balaraj, Juanita]

Hello All,



Here are last 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

============

18-August-23
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)
- Update the "Install StarlingX Kuberbetes in a virtual environment" docs; https://docs.starlingx.io/r/stx.8.0/deploy_install_guides/release/index-install-r7-8966076f0e81.html
  - Discussion about Merging the Installation Guides ; Virtual env with the Bare metal docs. WIP - https://review.opendev.org/c/starlingx/docs/+/876107
  -  Split the docs and retain them as separate guides at a high level. Resue content from Bare Metal in the Virtual env docs.
- Discussion about the tox version : https://review.opendev.org/c/starlingx/docs/+/890833 - AR Ron / Bruno (Allow list to be reviewed) - AR Ron
 - Doc gerrit reviews raised - Process to be followed - See the Documentation Contributor Guide - https://docs.starlingx.io/contributor/doc_contribute_guide.html  - AR Juanita - DONE sent an email to the Starlingx discuss group.
- 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.
- Stories that are in master should this be picked to r8 - AR Juanita - Confirmed this is not required and stays in Stx master. DONE
- https://docs.starlingx.io/r/stx.7.0/backup/kubernetes/backing-up-starlingx-system-data.html - AR Ron to create a LP bug to remove the Important Notice or fix the version string - DONE version string fixed.
- https://review.opendev.org/c/starlingx/docs/+/889408 - AR Ron to check if this impacts other releases
Gerrit reviews:
-  Open Reviews pending; https://review.opendev.org/q/starlingx/docs+status:open  - Merged 3 Reviews
Launchpad Doc Bugs:
- https://bugs.launchpad.net/starlingx/+bugs?field.tag=stx.docs Total 11 outstanding bugs. The DOC team to create LP defects corresponding with any DS defects - WIP. Teams to add all the impacted Releases when raising a LP bug.
Miscellaneous Updates:
- We have a fault that is preventing LPs from closing when the corresponding Gerrit WFs. Ron spoke with Jeremy Stanley, who reproduced the bug and is investigating. - Pending - Ghada sent out an email to the Stx discuss group; https://lists.starlingx.io/pipermail/starlingx-discuss/2023-August/014361.html - Awaiting Closure
- Ron to update the Verified H/W page with the automated script updates 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
-  Sphinx Tools - Need to have further discussions about the version used upstream vs. downstream - AR Ron -To determine version. - Docker Container upstream / downstream - AR Ron (Discuss it with Greg / Ildiko) - a long term project -  Pending
-  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-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/20230821/7e67eb35/attachment-0001.htm>