[Starlingx-discuss] [docs] [meeting] Docs team notes 30-11-22

[Balaraj, Juanita]

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



Thanks,

Juanita Balaraj

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



30-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 - Every one to be cautious about merge conflicts till this review this merged..

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

    -  Reviewers need to refer to https://docs.starlingx.io/fault-mgmt/index-fault-98d5f50a9b8c.html to view updated alarms and log files.

   -  Alarm updates are only supported on Master - Manual updates need to be implemented on the branches for alarms (events.yaml) since script is not supported on the branches as of date.

    - 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\) - To be cleaned up in rst files as the files are being updated for any doc Gerrit reviews.

- Numbering in the Install Guides is causing issues - AR Ron to check

Gerrit Reviews: Attention Needed from ALL core reviewers before DOC Reviews are merged

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

NOTE: All core reviewers to review and +1 or WF the Doc reviews at : https://review.opendev.org/q/starlingx/docs+status:open

Launchpad Doc Bugs:

- https://bugs.launchpad.net/starlingx/+bugs?field.tag=stx.docs Total 11 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)

_______________________________________________

Starlingx-discuss mailing list

Starlingx-discuss at lists.starlingx.io<mailto:Starlingx-discuss at 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$>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.starlingx.io/pipermail/starlingx-discuss/attachments/20221130/f374c1da/attachment-0001.htm>