[Starlingx-discuss] [docs] [meeting] Docs team notes 29-Sep-21

[Camp, MaryX]

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
==========
29-Sep-21
All -- reviews merged since last meeting:  14    
      
All -- bug status -- 17 total - team agrees to defer all low priority LP until the upstreaming effort is completed. 
6 LP are WIP against API documentation, which is generated from source code (low priority). 
Query for LP that are tagged for docs:  https://bugs.launchpad.net/starlingx/+bugs?field.tag=stx.docs

Status/questions/opens

Ron demoed the unique file name utility - must be in Linux terminal to run it. 
  How to details are in the Doc Contributor's guide here:   https://docs.starlingx.io/contributor/doc_contribute_guide.html#create-rst-files

Juanita - cherry picks in progress -  done

Mary's AR from last week: check topics against Greg's "docs.starlingx.outline" from last year and come up with actions.
Mary checked the Configuration guide only: https://docs.starlingx.io/configuration/index.html 
Opens: Docker Proxy Config doesn't have a corresponding replacement file. 2 stubs have no replacements. Details below.
Suggestions:  should we move all of this to a new Archive category? Do we need to redirect the old links to the new ones?
The WR team will bring all of this up with Greg in their regular Friday meeting. 

CONFIGURATION:  https://docs.starlingx.io/configuration/index.html
General Configuration
         Branding Configuration  [STUB]  -> MOVED to SystemConfigAndMgmt SECTION confirmed
            https://docs.starlingx.io/system_configuration/kubernetes/branding-the-login-banner-during-commissioning.html

         Certificate Configuration  -> MOVED to Security SECTION confirmed 
            https://docs.starlingx.io/security/kubernetes/https-access-overview.html

         Host Configuration [STUB]  -> MOVED to NodeConfigAndMgmt SECTION confirmed  
            https://docs.starlingx.io/node_management/index.html

        [not in Greg's doc]  Host FPGA Configuration - Intel N3000  -> confirmed in Node Management guide       
                     https://docs.starlingx.io/node_management/kubernetes/index.html#intel-n3000-fpga-support

         Host Interface and Network Configuration  -> MOVED to NodeConfigAndMgmt SECTION confirmed
            https://docs.starlingx.io/node_management/index.html

         Docker Proxy Configuration   -> MOVED to SystemConfigAndMgmt SECTION
             OPEN: This guide is referred to in all the Installation guides in multiple places. https://docs.starlingx.io/configuration/docker_proxy_config.html
             Is this the replacement?  https://docs.starlingx.io/security/kubernetes/connect-to-container-registries-through-a-firewall-or-proxy.html

         System Configuration  [STUB]  -> MOVED to SystemConfigAndMgmt SECTION confirmed
            https://docs.starlingx.io/system_configuration/index.html

         Time Configuration  [STUB]  -> MOVED to SystemConfigAndMgmt SECTION confirmed
            https://docs.starlingx.io/system_configuration/kubernetes/configuring-ntp-servers-and-services-using-horizon.html
            
StarlingX-Kubernetes Configuration
         Authenticating Kubernetes Users with Windows Active Directory -> MOVED to Security confirmed
           https://docs.starlingx.io/security/kubernetes/overview-of-windows-active-directory.html

         Persistent Volume Configuration  [STUB]  -> MOVED to Storage SECTION confirmed
           https://docs.starlingx.io/storage/kubernetes/about-persistent-volume-support.html

         Pod Security Policies  -> MOVED to Security SECTION  confirmed  
            https://docs.starlingx.io/security/kubernetes/pod-security-policies.html

         Resource Policies        -> MOVED to Security SECTION  confirmed
            https://docs.starlingx.io/security/kubernetes/resource-management.html

         Upgrade Kubernetes version   -> MOVED to Updates/Upgrades SECTION  confirmed
            https://docs.starlingx.io/updates/kubernetes/manual-kubernetes-components-upgrade.html

StarlingX-OpenStack Configuration
         OpenStack Cinder File System Configuration   -> MOVED to Storage SECTION confirmed
            https://docs.starlingx.io/storage/openstack/configure-an-optional-cinder-file-system.html

         OpenStack Ironic Configuration [STUB]  -> MOVED to SystemConfigAndMgmt SECTION  <empty>

         OpenStack Swift Configuration  [STUB]   -> MOVED to SystemConfigAndMgmt SECTION <empty>