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. 

Note that there will be no meeting on Dec 22 or 29, 2023

  [1]   Call logistics: https://wiki.openstack.org/wiki/Starlingx/Meetings

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

Thanks, 

Ron Stone

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

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

- Note: Dec 22 and 29 stx-docs meetings cancelled.

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

    - 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 - 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 - Pending Future update

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)

- 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.

- Docs builds now check for and will error on duplicate abbrev anchors: https://review.opendev.org/c/starlingx/docs/+/902298 (DONE)

- We now have version substitutions for use in StX or partner contexts, e.g. |v_r8| is r8 but something else in partner builds. See

https://review.opendev.org/c/starlingx/docs/+/902405 (DONE)

• https://docs.openstack.org/contributors/code-and-documentation/using-gerrit.html#reviewing-changes

• https://docs.starlingx.io/developer_resources/code-submission-guide.html

https://docs.openstack.org/project-team-guide/review-the-openstack-way.html; 

Gerrit reviews:

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

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

Launchpad Doc Bugs: 

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

Miscellaneous Updates:

- 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