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

  [2]   Tracking Etherpad: https://etherpad.openstack.org/p/stx-documentation

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@lists.starlingx.io

http://lists.starlingx.io/cgi-bin/mailman/listinfo/starlingx-discuss