release notes and config guide missing new settings for Newton

Bug #1640504 reported by Matt Fischer on 2016-11-09
16
This bug affects 2 people
Affects Status Importance Assigned to Milestone
OpenStack Identity (keystone)
Medium
guoshan
openstack-manuals
Undecided
guoshan

Bug Description

OpenStack operators and folks who automate openstack deployments with tools like puppet rely on the release notes [1] and config guides [2] to highlight new, changed, deleted, and deprecated config options. For Keystone Newton both of these guides are missing many features, with one prime example being the new PCI-DSS features [3]. The release notes actually fail to mention these at all although they are documented elsewhere if you knew that you should be looking for them.

The config reference only mentions 1 deprecation, beyond PCI-DSS there was probably more and they are all missing:
http://docs.openstack.org/newton/config-reference/tables/conf-changes/keystone.html

Compare this to the new and updated section for kilo which was complete and useful:
http://docs.openstack.org/kilo/config-reference/content/keystone-conf-changes-kilo.html

[1] - http://docs.openstack.org/newton/config-reference/tables/conf-changes/keystone.html
[2] - http://docs.openstack.org/releasenotes/keystone/newton.html
[3] - http://docs.openstack.org/developer/keystone/security_compliance.html

Matt Fischer (mfisch) on 2016-11-09
description: updated
tags: added: documentation
Changed in keystone:
status: New → Confirmed
importance: Undecided → Medium
guoshan (guoshan) on 2016-11-24
Changed in keystone:
assignee: nobody → guoshan (guoshan)
Changed in openstack-manuals:
assignee: nobody → guoshan (guoshan)
status: New → In Progress

Reviewed: https://review.openstack.org/405711
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=260a31067d58d045477908de62bcc2e6798e1bae
Submitter: Jenkins
Branch: master

commit 260a31067d58d045477908de62bcc2e6798e1bae
Author: jolie <email address hidden>
Date: Fri Dec 2 09:45:59 2016 +0800

    release notes and config guide new settings

    OpenStack operators and folks who automate openstack deployments with
    tools like puppet rely on the release notes and config guides to
    highlight new, changed, deleted, and deprecated config options.

    Change-Id: I15abb241af8a41edc3dd3850b08be4ab7a31c9c5
    Closes-bug:#1640504

Changed in openstack-manuals:
status: In Progress → Fix Released
Steve Martinelli (stevemar) wrote :

Closing this one from the keystone side, as it's fixed from our point of view. Thanks for the bug report Matt, and thank you guoshan for fixing it!

Changed in keystone:
status: Confirmed → Invalid

Reviewed: https://review.openstack.org/438863
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=bf6edca4e50aed66a0bb5a538c3906eb1510eebc
Submitter: Jenkins
Branch: stable/newton

commit bf6edca4e50aed66a0bb5a538c3906eb1510eebc
Author: jolie <email address hidden>
Date: Fri Dec 2 09:45:59 2016 +0800

    release notes and config guide new settings

    OpenStack operators and folks who automate openstack deployments with
    tools like puppet rely on the release notes and config guides to
    highlight new, changed, deleted, and deprecated config options.

    Change-Id: I15abb241af8a41edc3dd3850b08be4ab7a31c9c5
    Closes-bug:#1640504
    (cherry picked from commit 260a31067d58d045477908de62bcc2e6798e1bae)

tags: added: in-stable-newton

This issue was fixed in the openstack/openstack-manuals 15.0.0 release.

To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Duplicates of this bug

Other bug subscribers