Starlingx-discuss] [docs] [meeting] Docs team notes 24/07/2026
Hello All, Here are last week 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$> 24 July 2026 Release Tracking: StarlingX Release Plan - stx.13.0 Features: https://docs.google.com/spreadsheets/d/1j0R3d0RdqSBrx_T9nn-3kjESNUyTOrP2my0B... - Release Date: October 21, 2026 Tasks / Actions: Discuss about |Prefix| strings in the docs - Mili to fix - Katherine to see if this can be updated in the Doc Agents..WIP Git Commit Messages Best Practice: https://wiki.openstack.org/wiki/GitCommitMessages - AR Team to go through the process. https://docs.openstack.org/cinder/latest/ - PDFs are being generated from the Page - Juanita to find out who maintains the OpenStack Docs. https://docs.openstack.org/nova/latest/ - Ask Ildiko who maintains the OpenStack Documentation. The search functionality too works from there...Ildiko advised me to reach out to the Community. Working with Caio / Scott to see if this can be addressed in Zuul - AR Juanita - Update the Verified H/W page - Work with Michel's Team / Yue Tao / Jiping Ma / Guilherme - AR Juanita - WIP - Juanita to coordiate with the Eng. teams to get this automated - WIP - Juanita - Installation Guide Restructuring is WIP - Petsy, - Planning Guide - WIP Katherine - Updates and Upgrades - On Hold - OpenStack Introduction / Planning Guide - Elisa WIP - OpenStack Operations Guide - TOC available - Sign off Received from Eng. - Petsy WIP - OpenStack Upgrades and Updates - On Hold - RESTAPIs - Clean up the Upstream RESTAPIs - Processing (Filters to be used) - AR / Dev Team (Jim's team to provide a list of updates and clean up the legacy RESTAPs. - Coordinate with Tee / Jim - Demo completed. Doc Script to be evaluated. - AR Ron / Juanita - WIP - Integrate .patch files / Agent files into the stx repos; https://review.opendev.org/c/starlingx/docs/+/981539 - AR Ron / Juanita - WIP - .patch file process to be updated in the Contributor Guide; https://docs.starlingx.io/contributor/index.html - AR Juanita to check with Dev Eng to get the process documented - Events.yaml file - To send out an email to the community....and update the process in the Contributor Guide; https://docs.starlingx.io/contributor/index.html- AR Juanita - To check with Ron, if he can add updates about the events.yaml file - To update the StarlingX docs site with the TOC and missing OpenStack categories - AR Petsy / AR Juanita - Discussed with Greg, this can be done at a later time. - WIP - Dont patch back doc updates if its tied to a S/w Defect....AR Stx Docs Team - Do not add any updates in the Developer Resources Guide - AR Stx Docs Team - Gerrit Code Review; https://review.opendev.org/c/starlingx/docs/+/989588 - AR Juantia to follow up with Rohin for OpenStack Verified H/w automation - AR Elisa - https://review.opendev.org/c/starlingx/docs/+/982621 - Juanita to follow up with Emilia / Jim Issues / Risks: - IMPORTANT: Stx site storage is full - Need to recheck all our Stx Releases starting from Stx 5.0 till 10.0;- Earlier releases need to be deleted - AR Juanita / Ron - Discussed with Greg, not to delete for now. Probably around July 2026. - Zuul Builds are passing even though there are errors.....AR Elisa to check with Ron - This is new, when the content is only downstream and it is in the upstream file zuul will not consider it - DONE - Eng. Gerrit reviews showing on the Doc Dashboard - AR Juanita - Files creeping into working branch after running tox - WIP talk to Ron Gerrit reviews: Open Reviews pending; https://review.opendev.org/q/starlingx/docs+status:open - 3 reviews merged Check Reviews done by the Eng. teams - https://review.opendev.org/c/starlingx/docs/+/996792; Story Board: Story Board: https://storyboard.openstack.org/#!/project/starlingx/docs Launchpad Doc Bugs: https://bugs.launchpad.net/starlingx/+bugs?field.tag=stx.docs 4 outstanding launchpad bugs (3 don't belong to the Docs team, waiting for closure from assignee) - AR Juanita - Triage the Bugs. 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 StarlingX Releases: https://etherpad.opendev.org/p/stx-releases ____________________________ Starlingx-discuss mailing list Starlingx-discuss@lists.starlingx.io<mailto:Starlingx-discuss@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$>
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<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$> 31 July 2026 Release Tracking: StarlingX Release Plan - stx.13.0 Features: https://docs.google.com/spreadsheets/d/1j0R3d0RdqSBrx_T9nn-3kjESNUyTOrP2my0B... - Release Date: October 21, 2026 Tasks / Actions: - Discuss about |Prefix| strings in the docs - Mili to fix - Katherine to see if this can be updated in the Doc Agents..WIP (Discuss with Cole / Ron) - StarlingX Docs Restructuring https://docs.starlingx.io/index.html - Link to the template; - AR WIP Katherine to start investigating; https://opendev.org/starlingx/specs/src/branch/master/doc/source/specs/stx-1... - Git Commit Messages Best Practice: https://wiki.openstack.org/wiki/GitCommitMessages - AR Team to go through the process. https://docs.openstack.org/cinder/latest/ - PDFs are being generated from the Page - Juanita to find out who maintains the OpenStack Docs. https://docs.openstack.org/nova/latest/ - Ask Ildiko who maintains the OpenStack Documentation. The search functionality too works from there...Ildiko advised me to reach out to the Community. Working with Caio / Scott to see if this can be addressed in Zuul - AR Juanita - Update the Verified H/W page - Work with Michel's Team / Yue Tao / Jiping Ma / Guilherme - AR Juanita - WIP - Juanita to coordiate with the Eng. teams to get this automated - WIP - Juanita - Installation Guide Restructuring; https://review.opendev.org/c/starlingx/docs/+/986316 is WIP - Petsy, - Planning Guide ; https://review.opendev.org/c/starlingx/docs/+/996833 - WIP Katherine (To add reviewers) - Updates and Upgrades - On Hold - OpenStack Introduction / Planning Guide - Elisa WIP - OpenStack Operations Guide - TOC available - On Hold - OpenStack Upgrades and Updates - On Hold - RESTAPIs - Clean up the Upstream RESTAPIs - Processing (Filters to be used) - AR / Dev Team (Jim's team to provide a list of updates and clean up the legacy RESTAPs. - Coordinate with Tee / Jim - Demo completed. Doc Script to be evaluated. - AR Ron / Juanita - WIP - Integrate Agent files into the stx repos; https://review.opendev.org/c/starlingx/docs/+/981539 - AR Ron / Juanita - WIP - .patch file process to be updated in the Contributor Guide; https://docs.starlingx.io/contributor/index.html - AR Juanita to check with Dev Eng to get the process documented - Events.yaml file - To send out an email to the community....and update the process in the Contributor Guide; https://docs.starlingx.io/contributor/index.html- AR Juanita - To check with Ron, if he can add updates about the events.yaml file - To update the StarlingX docs site with the TOC and missing OpenStack categories - AR Petsy / AR Juanita - Discussed with Greg, this can be done at a later time. - WIP - Dont patch back doc updates if its tied to a S/w Defect....AR Stx Docs Team - Do not add any updates in the Developer Resources Guide - AR Stx Docs Team - Gerrit Code Review; https://review.opendev.org/c/starlingx/docs/+/989588 - AR Juantia to follow up with Rohin for OpenStack Verified H/w automation - AR Elisa - https://review.opendev.org/c/starlingx/docs/+/982621 - Juanita to follow up with Emilia / Jim Issues / Risks: - IMPORTANT: Stx site storage is full - Need to recheck all our Stx Releases starting from Stx 5.0 till 10.0;- Earlier releases need to be deleted - AR Juanita / Ron - Discussed with Greg, not to delete for now. Probably around July 2026. - Eng. Gerrit reviews showing on the Doc Dashboard - AR Juanita - Files creeping into working branch after running tox - WIP talk to Ron Gerrit reviews: Open Reviews pending; https://review.opendev.org/q/starlingx/docs+status:open - 3 reviews merged Check Reviews done by the Eng. teams - https://review.opendev.org/c/starlingx/docs/+/996792; Story Board: Story Board: https://storyboard.openstack.org/#!/project/starlingx/docs Launchpad Doc Bugs: https://bugs.launchpad.net/starlingx/+bugs?field.tag=stx.docs 4 outstanding launchpad bugs (3 don't belong to the Docs team, waiting for closure from assignee) - AR Juanita - Triage the Bugs. 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 StarlingX Releases: https://etherpad.opendev.org/p/stx-releases ____________________________ Starlingx-discuss mailing list Starlingx-discuss@lists.starlingx.io<mailto:Starlingx-discuss@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$>
participants (2)
-
Balaraj, Juanita
-
Goncalves, Elisamara Aoki