Hello All,

 

Here are this week’s docs team meeting minutes.

 

Please note that our next meeting will be January 8th, 2020.

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

Cheers,
Kris

 

Current agenda and notes

 

2019-18-11

·         All -- reviews in progress and recent merges -- https://review.opendev.org/#/q/project:starlingx/docs

§  https://review.opendev.org/#/c/695627/ - Move to new OpenStack - pending tech review

§  https://review.opendev.org/#/c/699517/ - R2.0.2 release notes - staged for release

§  https://review.opendev.org/#/c/693761/ - Still pending dependency, merge conflict fixed

§  https://review.opendev.org/#/c/692202/ - STX in a box - pending

·         Abraham and all -- bug status -- https://bugs.launchpad.net/starlingx/+bugs?field.tag=stx.docs

·         Kris -- Releases

§  R3: Target content for release: https://etherpad.openstack.org/p/stx-r3-target-content

§  We have some remaining items flagged for R3: https://storyboard.openstack.org/#!/story/list?tags=stx.docs&tags=stx.3.0  

§  R4 install guides set up.

§  Would like to engage with engineering teams once planning is finalized/more solid.  ID features/updates requiring docs, and people on teams to contribute.

·         Greg/Kris -- semi urgent docs update -- Need to update R3 docs to provide caution re updating Kubernetes secrets (untill long term approach is implemented)

·         Bruce -- Improve www.starlingx.io -- https://storyboard.openstack.org/#!/story/2007029

·         Kris -- Docs team holiday coverage

·         Kris -- Ongoing tasks:

§  Lets do this as a blog post: https://www.starlingx.io/blog/

§  Need to write a summary (Mike), then link to article. Submit as a PR to site (Kris).

§  Target - first part of January

§  Approach is to highlight the differences w/ OpenStack (we inherit/use a lot from OpenStack guides)

§  Recommend: move Build STX guide to dev resources (from contribute landing)

§  Contributor landing page merits a review: What is the logical split of content between contributor and developer resources? 

·         Move https://wiki.openstack.org/wiki/StarlingX/CodeSubmissionGuidelines into docs (under contributor guides) - yes (Kris)

§  Draft in review https://review.opendev.org/#/c/692202/ 

§  Hosting qcow2 images: Updated image/build instructions provided. Needs review. (send to Scott and Saul) - will send updates shortly.  

·         Kris -- Content questions

·         Kris --  potential new content

§  Log story?

§  https://wiki.openstack.org/wiki/StarlingX/Packet_SIG

§  Explore this as content for a new guide

§  Log story?