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  

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

  

Thanks,  

Juanita Balaraj

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

 

26-Janurary-24

 

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 moved from Stx 9.0. See https://etherpad.opendev.org/p/stx-cores for more details.

- StarlingX Docs builds started failing early this week due to a change in underlying Sphinx dependencies inherited from OpenStack. - DONE

  We can override the issue in local builds but not in Zuul. The solution is to bump Sphinx to at least v5.0. This has been done. - DONE

- We need to attempt to catch up to a more recent version of Sphinx that better aligns with OpenStack and stay current: AR: Ron (Update to a more current version)

   - Discussion about upgrading to the latest Sphinx / tox version; https://pypi.org/project/tox/: https://review.opendev.org/c/starlingx/docs/+/890833 - AR Ron - Pending Future update

- Discussion about Merging the Installation Guides ; Virtual env with the Bare metal docs.  https://review.opendev.org/c/starlingx/docs/+/876107  - DONE

    - Option discussed and solution is to maintain the virtual guide and pull the shared content in from Baremetal  with tabs on the Virtual docs...as per discussion with Greg

    - This has now been extended to simplex, standard, and dedicated installs.- DONE

Labels:  Modify long topic labels in the docs...- AR Elisa. Require a Utlity script to fix this - AR Ron (trim long file names in tox -e newfile) - DONE

- StarlingX Contributor Guide / Code Submission Guideline - AR Juanita to work with SteveG to update the  current StarlingX code submission guidelines for this topic; See  https://etherpad.opendev.org/p/stxhttps://review.opendev.org/c/starlingx/docs/+/902298-status for more details.

Gerrit reviews:

https://docs.starlingx.io/contributor/index.html

-  Open Reviews pending; https://review.opendev.org/q/starlingx/docs+status:open  - Merged ~5 Reviews for all releases.

Launchpad Doc Bugs:

- https://bugs.launchpad.net/starlingx/+bugs?field.tag=stx.docs 12 outstanding launchpad bugs.

Miscellaneous Updates:

Virtual Project Teams Gathering (PTG)[1] event is scheduled for April 8-12, 2024;

- https://etherpad.opendev.org/p/stx-ptg-planning-april-2024

- PrePTG https://etherpad.opendev.org/p/opendev-preptg-202402

- 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

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