Hello All,

Here are this week’s docs team meeting minutes (short form). Details in [2].

Join us if you have interest in StarlingX docs! We meet on Wednesdays 12:30 PST.

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

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

Thanks,

Juanita Balaraj

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

16-Nov-22

StarlingX 8.0 Release:

- https://docs.google.com/spreadsheets/d/1cjhRQm717zOTo2ngs5SEs3elhJwSRxFAI-ruqJaBe80/edit#gid=1107209846 - Doc Tasks created - Doc Team to ensure Stories/Tasks are added to the commit messages - Ongoing WIP

- https://review.opendev.org/c/starlingx/docs/+/862705: Verified Hardware Updates - WIP - Discuss with prime

-   https://review.opendev.org/c/starlingx/docs/+/861367 Flatten TOC for better customer experience - AR Ron

 - O-RAN updates  https://storyboard.openstack.org/#!/story/2010278- Updates are available in: https://review.opendev.org/c/starlingx/docs/+/862367 - Stx Doc team to review and provide comments - DONE

events.yaml

- Automation of the events.yaml file in the docs - AR Ron / Juanita - WIP

• Dependent on Fault Management events.yaml review; https://review.opendev.org/c/starlingx/fault/+/863574 -    This review is merged.
• All alarms and log rst files will be removed from the StarlingX docs (For example; 100-series-alarm-messages; 400-series-customer-log-messages) to accommodate this automation.
• These files will be replaced by build-time artifacts (since a script has been created to capture these alarms and log files).
• Reviewers need to refer to https://docs.starlingx.io/fault-mgmt/index-fault-98d5f50a9b8c.html to view updated alarms and log files.
• All alarms and logs will be included in the Fault Management guide.
• Alarm updates are only supported on Master
• Doc Team to be included as part of the Gerrit review cycle for any alarm updates in the event.yaml files - To discuss details with Greg Waines / Frank Miller  (To update the Contributor Guide after discussion with the primes with the required process)

Installation Guide - Restructuring of the Installation Guide is WIP and the plan is to deliver for stx 8.0.

Miscellaneous Updates:

- Backslashes to be removed from rst files wherever applicable especially in code blocks, for example,

\(code\_remove\)

- GPU Operator Removal on WRO - AR Elisa - To be reviewed by PV before it is merged. - https://review.opendev.org/c/starlingx/docs/+/861904

Gerrit Reviews:

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

- To verify if this Gerrit review is applicable to earlier releases of StarlingX - https://review.opendev.org/c/starlingx/docs/+/864440 - AR Elaine

Launchpad Doc Bugs:

- https://bugs.launchpad.net/starlingx/+bugs?field.tag=stx.docs Total 9 bugs outstanding - The DOC team to create LP defects corresponding with any DS defects - WIP

General Updates:

-  Operations Guide Archive - On Hold until further clarifications are discussed with Greg (https://review.opendev.org/c/starlingx/docs/+/822030)

Elections: Nov 15-22

[1] https://docs.starlingx.io/election/#election-officials

[2] https://docs.starlingx.io/governance/reference/tsc/index.html

_______________________________________________

Starlingx-discuss mailing list

Starlingx-discuss@lists.starlingx.io

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