[Starlingx-discuss] [docs] [meeting] Docs team notes 01-Dec-21
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, Mary Camp ========== 01-Dec-21 . All -- reviews merged since last meeting: 18 https://review.opendev.org/q/project:starlingx/docs+status:merged . All -- bug status -- 9 total - team agrees to defer all low priority LP until the upstreaming effort is completed. Status/questions/opens Release Notes for R6.0 Mary will start a review with a WIP draft. Add bullet saying CPU Manager for Kubernetes is no longer supported (deprecated). New limitation coming from Chris Friesen (may be differences between upstream & downstream RN and how to handle). Juanita will confirm with him and keep me posted. (Docker registry for GHCR.io) How to handle Install Guides for R6.0 Current plan is to defer branching the docs repo until the actual release (instead of 2-3 weeks early like the software does). This idea came from Scott, Greg and the docs team. We will continue as we have now (latest/7 and supported/6 on main branch, all others on R6 branch). Mary find notes about updating version dropdown in the theme. Mary has ARs to remove the old guides into archive/deprecated folder and do reviews. WR team did a training for gerrit reviews - approx 55 people attended! They will likely do some follow-up sessions also. Notification of changes (Ron) Recently there was a change to the constraints file that impacted us. How could we find out about these in advance? Find out if the infra/oslo team has meeting minutes that we could monitor? What are the issues we are concerned about: version of sphinx, theme changes. Ask if they can provide some guidance for what to watch for. Is it oslo team only or is there another team that covers theme? During the meeting, we looked at: http://lists.openstack.org/pipermail/openstack-discuss/ https://meetings.opendev.org/meetings/oslo/2021/ After the meeting, I found this in the OpenStack Projects list: https://governance.openstack.org/tc/reference/projects/oslo.html The Oslo team does support theme.
On 2021-12-02 00:14:41 +0000 (+0000), Camp, MaryX wrote: [...]
Notification of changes (Ron) Recently there was a change to the constraints file that impacted us. How could we find out about these in advance? Find out if the infra/oslo team has meeting minutes that we could monitor? What are the issues we are concerned about: version of sphinx, theme changes. Ask if they can provide some guidance for what to watch for. Is it oslo team only or is there another team that covers theme? During the meeting, we looked at: http://lists.openstack.org/pipermail/openstack-discuss/ https://meetings.opendev.org/meetings/oslo/2021/ After the meeting, I found this in the OpenStack Projects list: https://governance.openstack.org/tc/reference/projects/oslo.html The Oslo team does support theme.
Those are some of the reasons I suggested StarlingX may want to consider forking that theme, stripping out the OpenStack-only bits, and moving it into the docs repo. I started a PoC of that with https://review.opendev.org/750005 and https://review.opendev.org/750006 but did not find time to finish it. The original has almost certainly diverged enough since that time that the changes would need to be recreated from scratch anyway at this point. -- Jeremy Stanley
Thanks Jeremy for the advice -- something for us to consider for 2022! -Mary C. -----Original Message----- From: Jeremy Stanley <fungi@yuggoth.org> Sent: Wednesday, December 1, 2021 7:26 PM To: starlingx-discuss@lists.starlingx.io Subject: Re: [Starlingx-discuss] [docs] [meeting] Docs team notes 01-Dec-21 On 2021-12-02 00:14:41 +0000 (+0000), Camp, MaryX wrote: [...]
Notification of changes (Ron) Recently there was a change to the constraints file that impacted us. How could we find out about these in advance? Find out if the infra/oslo team has meeting minutes that we could monitor? What are the issues we are concerned about: version of sphinx, theme changes. Ask if they can provide some guidance for what to watch for. Is it oslo team only or is there another team that covers theme? During the meeting, we looked at: http://lists.openstack.org/pipermail/openstack-discuss/ https://meetings.opendev.org/meetings/oslo/2021/ After the meeting, I found this in the OpenStack Projects list: https://governance.openstack.org/tc/reference/projects/oslo.html The Oslo team does support theme.
Those are some of the reasons I suggested StarlingX may want to consider forking that theme, stripping out the OpenStack-only bits, and moving it into the docs repo. I started a PoC of that with https://review.opendev.org/750005 and https://review.opendev.org/750006 but did not find time to finish it. The original has almost certainly diverged enough since that time that the changes would need to be recreated from scratch anyway at this point. -- Jeremy Stanley
participants (2)
-
Camp, MaryX
-
Jeremy Stanley