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,
Ron Stone
============
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.
We can overide the issue in local builds but not in Zuul. The solution is to bump Sphinx to at least v5.0. This has been 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
- 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
- This has now been extended to simplex, standard, and dedicated installs.
- 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) - 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 ~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