[Starlingx-discuss] [docs][meetings] docs team meeting minutes 2019-10-09

Wed Oct 9 22:10:39 UTC 2019

Join us if you have interest in StarlingX docs! We meet Wednesdays, and call logistics are here: https://wiki.openstack.org/wiki/Starlingx/Meetings. Our etherpad is here: https://etherpad.openstack.org/p/stx-documentation.

-- Mike

Current agenda and notes

2019-10-09

  *   Mike -- upcoming elections --
     *   Need to update the team list at https://opendev.org/openstack/governance/src/commit/69d2ef8c1c79323a3d9eb0b1f7d741cef3d2c59f/reference/projects.yaml#L651-L795
     *   Those in the list above will elect the doc team PL, which is the role Mike is playing now. Any and all are invited to self-nominate for the job for the upcoming election! Deadline is 10/13.
     *   The self-nomination process is described here: http://lists.starlingx.io/pipermail/starlingx-discuss/2019-October/006415.html
     *   What happens if nobody self-nominates?
  *   All -- reviews in progress and recent merges --
     *   See summary at https://review.opendev.org/#/q/project:starlingx/docs.
     *   Recent merges. Great job team!
        *   https://review.opendev.org/#/c/686465/ -- Fix commands in section Configure controller-1 -- Closes-Bug: #1844656 -- MERGED
        *   https://review.opendev.org/#/c/686490/ -- Add content to Access OpenStack doc -- Closes-Bug: #1837931 -- MERGED
        *   https://review.opendev.org/#/c/686851/ -- Remove never ending while loops from R2 install guides -- MERGED
        *   https://review.opendev.org/#/c/687170/ -- Initial setup for R3 docs -- MERGED
        *   https://review.opendev.org/#/c/687431/ -- Minor wording updates for clarity capturing feedback from Bill Zvonar after he installed -- MERGED -- a follow-on PR is in progress to capture a few additional comments from Greg
     *   We have 2 open:
        *   https://review.opendev.org/#/c/687627/ -- Minor editorial revisions (R2, R3 install guides) -- follow-on to https://review.opendev.org/#/c/687431/ above.
        *   https://review.opendev.org/#/c/684820/ -- Introduction editorial updates -- This is Mary's sandbox for Gerrit familiarity and is set to workflow -1 on purpose. No urgency.
  *   Abraham and all -- bug status -- https://bugs.launchpad.net/starlingx/+bugs?field.tag=stx.docs
     *   Only one bug is open, and it's low-priority! We've closed several higher priority bugs recently.
     *   https://bugs.launchpad.net/starlingx/+bug/1835207 -- Abraham will ask for help in the community meeting to get this closed.
  *   Kris -- validate structure and plans for new config guide --
     *   Let's walk through this -- https://docs.google.com/document/d/1LsRk_h8-35QjtmDqjhaY_C1fDtC71S673bq1wVSKtC0
     *   Outcome of this discussion should be a good idea of what should go into the new config guide and what the landing page will look like.
     *   Kris will follow up with Greg on some open questions.
  *   Mike -- triage with intent to create new R3 stories (or update existing stories) as needed --
     *   A recent code change will impact R3 bare metal use cases (and possibly others). See https://drive.google.com/file/d/1pic5wr_69fJb94-o3JM7U2xKMJ0HpGJZ for details. Kris will create a PR.
     *   Change to Ansible Docker registry keys -- https://drive.google.com/file/d/1surBx44zzN3P3D13SUdc9m8tKDVQdAK2. Should go into config guide. Mike will create a subtask.
     *   New back up and restore feature -- https://drive.google.com/file/d/15fsxLL-Xw2a5hftJrN6_Bboi7Q1kPo0_. Should go into what may be a new admin/maintenance guide. Mike create story.
     *   This change to "manager.py" looks like a code change, not a doc issue. See https://storyboard.openstack.org/#!/story/2004707. Remove stx.docs tag? YES
     *   https://storyboard.openstack.org/#!/story/2004601 -- Change to conf.py suggested in https://review.opendev.org/#/c/624848/. Added +1. Tools repo.
     *   https://drive.google.com/file/d/1jDQOR0Nprjd4NPhxy-vPWFxb3YUrWZs8 -- STX project versioning -- lower priority but tagged now for stx.3.0. Mostly done.
  *   Bruce -- StarlingX-in-a-box -- We have two vectors on this --
     *   Erich's contribution -- https://drive.google.com/file/d/19127DWvfrSvpd9QNjHlbNX2-OEbruxKx
     *   Calsoft's contribution -- http://lists.starlingx.io/pipermail/starlingx-discuss/2019-September/006316.html  -- We believe this will go into our StarlingX-in-a-box topic as captured in https://storyboard.openstack.org/#!/story/2006622. Bruce has volunteered to help Sai with the contribution.
  *   Abraham -- help from the Q/A team --
     *   Distributed Cloud -- https://storyboard.openstack.org/#!/story/2005181
     *   GPU Kubernetes Plugin
     *   TSN -- subtask 36405 in https://storyboard.openstack.org/#!/story/2006289
     *   Redfish
     *   Infrastructure and cluster

Action required (AR) summary

Completed ARs are archived here: https://etherpad.openstack.org/p/stx-documentation-files-003

     *   <date task was assigned> -- <owner> -- <description + comments>
     *   2019-05-15 -- Abraham -- Review these code and terminology changes impacting user docs -- https://drive.google.com/file/d/1sCB-lrWhDIJLNAGWBt7wJ1_JxY21m71p -- and report back on specific actions required.
     *   2019-10-02 -- Abraham -- Ask for help in the community meeting to get https://bugs.launchpad.net/starlingx/+bug/1835207 closed.
     *   2019-10-02 -- Kris and Mary -- Update the contributor guide at https://docs.starlingx.io/contributor/doc_contribute_guide.html to reflect our current doc schema.
     *   2019-10-09 -- Kris -- Follow up with Greg to close open questions as called out in https://docs.google.com/document/d/1LsRk_h8-35QjtmDqjhaY_C1fDtC71S673bq1wVSKtC0.
     *   2019-10-09 -- Kris -- Create a one-line PR for this change -- https://drive.google.com/file/d/1pic5wr_69fJb94-o3JM7U2xKMJ0HpGJZ.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.starlingx.io/pipermail/starlingx-discuss/attachments/20191009/d5ad1839/attachment-0001.html>